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(57) Abstract: An industrial control user interface provides a flexible, extensible architecture for the provision of real-time process 
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technological convergence of disparate HMI products. The preferred embodiments offer open display page architecture via the 
separation of the provision of data and server specific user interactions from the implementation of individual page elements. The 
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TITLE: HUMAN MACHINE INTERFACE 

FIELD OF INVENTION 

The present invention relates to a human machine interface (HMT). 

The invention has been developed primarily for Industrial, Security, Life 
5 Safety, Access Control, Heating, Ventilation and Air Conditioning applications such 
as the monitoring of data generated by industrial processes and equipment, and will be 
described hereinafter with reference to that application. However, it will be 
appreciated that the invention is not limited to use in that particular field. 
BACKGROUND OF THE INVENTION 
10 Remote monitoring of data is frequently used in industrial settings. The desire 

for implementing such monitoring ranges from the need for centralised monitoring of 
relatively complex industrial systems to the convenience of allowing a small number 
of operators to monitor multiple data streams via a single workstation. In many cases, 
it is also desirable that the HMI allow operators to control at least some of the 
15 industrial processes and machines in relation to which the data is being collected. 

Historically, collection and display of industrial data on operator workstations 
has been dealt with on a proprietary basis, with application-specific software linking 
remote data sources with dedicated terminals. Whilst such systems have provided 
satisfactory performance, they are relatively time consxmiing to design, aad relatively 
20 inflexible once implemented. 

Another problem is that individually implemented software solutions are often 
limited in the types of data sources with which they can interface. 

One of the most profound developments of the last five years has been the 
staggering growth of the internet. This growth has changed public perceptions about 
25 the availability of data, about what to expect in a user interface, and how open and 
interoperable computer systems should be. Standalone computer systems are no 
longer acceptable to the market - the increasingly networked world is setting the pace 
and scope of change. 

In addition, this growth has led to a huge shift in development focus for 
30 practically every software organisation. The web has become the ubiquitous data 
delivery mechanism, and as software organisations focus their energies on harnessing 
its potential, the technologies which underpin its success are being pushed forward at 
ever-increasing rates. Where once the web was not mature enough to support 
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mission-critical ftmctions, such as major financial transactions or process control, it is 
clear that this is no longer the case. 

It is this growth which is driving investment into user interface technology, as 
the major stakeholders seek to establish the intemet as a viable business platform. As a 
5 result, current technological trends have meant the imderlying technologies are 
becoming increasingly more appropriate to the field of industrial process control. 

The development of what may be loosely termed "intemet technologies" has 
been extremely rapid, and has a very short history: 

■ December 1993: Only 200 known http servers existed. 

10 ■ December 1994: First W3C meeting. Over 200 members, charter to promote 
interoperability. 

■ October 1996: OLE Controls 96 Specification published. Promotes 
lightweight, wiadowless controls suitable for the web environment, and intended 
to add increasing sophistication to browser capabilities. 

15 ■ December 1996: Cascading Style Sheet specification. Introduced 2D 
positioning, size, colour, font attributes. 

■ July 1997: HTML 4.0 specification. Licluded scripts, objects, framesets, 
intemationalisation. Browser teclmology advanced appropriately. 

■ September 1997: Dynamic HTML, Document Object Model. Full access to 
20 the HTML object model, providing web pages with unprecedented power and 

flexibihty. 

■ September 1998: Intemet Explorer 5.0 Beta 2. Includes Vector Markup 
Language for vector graphics capabilities. 

■ late 1999: Office 2000 to use HTML/XML as document format for all suite 
25 products. Microsoft look to include sufficient functionality in HTML for it to be 

suitable for use by Visual Basic forms engine. 

In parallel Avith these developments has been an increasing awareness that 
HTML's origins as a language intended to store presentation information means its 
ability to store and represent data is severely limited. This limitation has led to the rise 
30 of XML, or extensible Markup Language, intended to work in concert with HTML to 
provide a means of storing both data and presentation information. 
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It was these treads that led the appHcant to consider the suitabiUty of such 
technologies for industrial control systems. 

The development requirements of an industrial control system indicate clearly 
that known web browsers are not suitable for the operator environment of an industrial 
5 control system. They may be acceptable for casual use, but the operator environment 
has specific requirements, such as restricted navigation, support for industrial 
keyboards, alarm and status mdication, and security. 

The partial solution to a number of these issues may be provided using a 
software package sold and marketed by Microsoft®. la particular, Microsoft® supply a 
10 rendering engine used in Intemet Explorer (known as MSHTML), for use by third-party 
developers wishing to integrate HTML renderiag capabilities into their applications. 
While this software package can represent a usefiil tool for system designers, its generic 
nature ensures that it will not automatically integrate or interact with other applications. 
Further although the invention in some aspects will be described in relation to this 
15 software package, it will be appreciated that other browser techniques may be used. 

Any discussion of the prior art throughout the specification should in no way 
be considered as an admission that such prior art is widely known or forms part of 
common general knowledge in the field. 
DISCLOSURE OF THE INVENTION 
20 It is an object of the present invention to overcome or ameliorate at least one of 

the disadvantages of the prior art, or to provide a usefixl altemative. 

According to a first aspect of the invention there is provided a Human Machine 
Interface (HMI) including: 

a display page including a plurality of display page elements; 
25 a data source manager including a plurality of data source components; and 

a binding engine which transfers data and commands between the data source 
components and the display page elements. 

Preferably, the display page further includes a plurahty of infrastructure 
components. More preferably, the data source components are server system specific 
30 data source components. Even more preferably, each display page has its own 
corresponding binding engine. 

Preferably also, the individual data source components are shared by more than 
one binding engine. 
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In a preferred form, the display page acts as a container for the page elements 
that make up the display page and provides the primary user interface thread of 
execution. More preferably, the page elements include any one or more element that 
can be included in an HTML file. More preferably, the page elements include one or 
5 more of: 

ActiveX controls; 

VML graphics elements; 

HTML elements; 

HTML scriptlets; and 
10 Java Applets. 

Preferably, the display page is constructed using a mixture of standard HTML 
and XML tags. More preferably, the HTML describes presentation aspects of the 
display page - that is the page elements - while the XML tags describe what data is 
required for the page and how that data is to be applied to the page. Even more 
15 preferably, the infrastructure components assist with the parsing of the XML content 
of the display page, the delivery of data to the display page and the initiation of server 
commands from display page elements. 

In a preferred form, at run time, the display page appears as an instance of a 
standard Document Object Model (DOM), More preferably, the DOM is the standard 
20 for the industry to which the HMI is applied. 

Preferably, the DOM provides the destination for data provided by the binding 
engine. More preferably, the DOM further provides the basis for the display page 
scripting environment. 

Preferably also, the display pages are capable of being encapsulated and re-used 
25 as encapsulated displays. More preferably, the encapsulation includes the 

parameterisation of any data references in the display page and the addition of 
properties, methods and events that allow the encapsulated display to act as a fully 
fledged component. Even more preferably, the encapsulated displays are embeddable. 
More preferably still, the encapsulated displa^^s are linked into containing display pages. 
30 Preferably, the display page is HTML based. 

In a preferred form, the data source manager manages a plurality of server 
system specific data source components that encapsulate the details of delivering data 
to and from particular server systems. More preferably, each data source component 
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presents data from a server system in the form of a hierarchical object model. Even 
more preferably, the data source manager pulls the separate data source component 
object models together into a unified data source object model (DSOM) that is used as 
the source of data for the binding engine. 
5 Preferably also, the data source components are informed of the data 

requirements for a particular display page by means of a data source definition that is 
stored as part of an HTML/XML display page file. 

In a preferred form, the server systems include one or more of a variety of 
different server system, a small subset of v^hich includes the server systems provided by 
10 Honejwell Limited and tliat are known as: 
Plantscape; 

Enterprise Buildings Integrator; 
TPS; 

TPA; 

15 QCS; 

Uniformance; 
OPC; and 
HCI. 

Preferably, the data binding engine takes the data provided by the data source 
20 object model and applies it to the display page. More preferably, the data binding 
engine takes the data provided by the data source object model and applies it to the 
display page in a way defined by binding definitions contained in the HTML/XML 
display page. Even more preferably, each display element that requires data has an 
associated binding definition that defines what data is required for the element and how 
25 it is to be applied to the element. 

Preferably also, the data binding engine is able to bind data to any property of 
the DOM. More preferably, the DOM includes the body element and any container 
elements that are used to organise other elements on the display page. More preferably, 
the binding engine uses transformations to perform the transfer of data from the data 
30 source object model to the display page. Even more preferably, the transformations 
transfer the data directly from the data source object model to the display page. It is 
also preferred that the transformations transforms the data as they transfer the data. 
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In a preferred form, the transformations include user written "OnDataChange" 
scripts and data driven page element "dynamics" such as rotation, path animation and 
break point animation. More preferably, the transformations are binary components. 
Even more preferably, the transformations are written using an XML syntax and script 
5 code. 

In a preferred form, the binding engine executes in an apartment managed by the 
data source manager and transfers data from the data source object model to the display 
page in a very efficient manner. 

The preferred embodiments of the invention provide an operator framework 
10 built around MSHTML to provide the ftmctionality specific to the needs of an industrial 
control system. Additionally, it has been found that these embodiments, using 
MSHTML as the underlying rendering engine, provide a flexible, extensible 
architecture for the provision of real-time process data to a state-of-the-art user 
interface. That is, the preferred embodiments make use of synergies that are possible 
15 from the interaction between the operator framework and the rendering engine. Again, 
while the embodiments make use of the MSHTML browser software, other browser 
techniques would be equally applicable. 
BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a schematic overview of the architecture according to the invention; 
20 Figure 2 is a schematic representation of an operator runtime environment of one 

embodunent of the invention; 

Figure 3 is a schematic overview of the display authoring that is utilised in 
preferred embodiments of the invention; 

Figure 4 is a schematic view of the authoring environment provided by one 
25 embodiment of the invention; 

Figure 5 is a schematic view of the PlantScape implementation scenario 
provided by an embodiment of the invention; 

Figure 6 is a schematic view of the TPS implementation scenario provided by an 
embodiment of the invention; 
30 Figure 7 is a schematic view of the TPS wearable computer remote cUent 

scenario provided by an embodiment of the invention; 

Figure 8 is a schematic view of the HiSpec implementation scenario provided by 
an embodiment of the invention; 
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Figure 9 is a schematic view of the TPA implementation scenario provided by 
an embodiment of the invention; 

Figure 1 0 is a schematic view of the reuse of configuration components 
provided by an embodiment of the invention; 
5 Figure 1 1 is a schematic view of the seamless transition between systems 

provided by an embodiment of the invention; 

Figure 12 is a schematic view of the general arrangement of these components in 
the architecture of a preferred embodiment of the invention; 

Figure 13 is a schematic view of a data source manager as shared resource 
10 within an embodiment of the invention; 

Figure 14 is a schematic view of the display page structured used in an 
embodiment of the invention; 

Figure 15 is a schematic representation of the data source architecture used in a 
preferred embodiment of the invention; 
15 Figure 1 6 is a schematic view of a data source used in an embodiment of the 

invention and which includes several data references; 

Figiure 17 is a schematic view of a data source used in an embodiment of the 
invention and which includes hierarchical data references; 

Figure 18 is a schematic view of the relationship between the data source 
20 manager, the data binding engine and the data source; 

Figure 19 is a schematic view of the relationship between a data reference that 
exposes a property, an event and a rowset to a binding object which is part of the 
Hendrix data binding architecture; 

Figure 20 illustrates the broad components in the Hendrix data binding 
25 architecture; 

Figure 21 is a schematic representation of a "thin client, remote server" system 
provided by an embodiment of the invention; 

Figure 22 is a schematic representation of a "thin client, single node" system 
provided by an embodiment of the invention; 
30 Figure 23 is a schematic representation of a "very thin chent, distinct middle 

tier" system provided by an embodiment of the invention; 

Figure 24 is a schematic representation of a "very thin cUent, middle tier" 
system provided by an embodiment of the invention; 
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Figure 25 is a schematic representation of the binding to the global data 
repository used by an embodiment of the invention; 

Figure 26 schematically illustrates the sequence of events upon page callup; 

Figure 27 schematically illustrates the general arrangement of the Hendrix data 
5 source architecture; 

Figure 28 schematically illustrates the components that constitute a data source, 
the main COM interfaces they implement and the main relationships they have with 
other parts of the Hendrix architecture. 

Figure 29 schematically illustrates the typical data source states and the methods 
10 that cause transitions between those states when a data source is being used to provide 
data to a run time UI framework; 

Figure 30 is a UML sequence diagram that illustrates the basic operation of a 
Hendrix data source at run time; 

Figure 3 1 schematically illustrates the typical data soxrrce states and the methods 
15 that cause traasitions between those states when a data source is being used by the 
Hendrix display builder; 

Figure 32 is a UML sequence diagram that describes a build mode sequence of 
events in which a new data source is created and configured to have a simple data object 
model consisting of a root data object containing one child data object. 
20 Figures 33 and 34 are a schematic representation of the various components 

used in the Hendrix runtime environment; 

Figure 35 is a schematic representation of the framework binding used in an 
embodiment of the Hendrix architecture; and 

Figure 36 is an illustration of some Windows user interface elements in a 
25 Windowless controL 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

Glossary of Terms 

ActiveX control: a reusable software component exposing its ftmctionality 
through COM interfaces. ActiveX controls cannot be run alone and must be loaded into 
30 a control container such as Microsoft Litemet Explorer, 
DHTML: Dynamic HTML. 
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DOM: Document Object Model. Industiy-standard object model for HTML 
scripting. 

Hendrix: The trademark used to identify the conmion architecture for the HMI 
systems developed by Honeywell Limited and which is applied to the embodiments of 
5 the invention described in this specification and marketed by Hone3well Limited and its 
associated entities. 

HMI: Human-machine interface. 

HSC: Hone3rwell Software Center. 

HTML: Hyper-text Markup Language. 
10 MSHTML: Microsoft-supplied HTML rendering-engine component. 

WWW: World-wide web. 

XML: Extensible Markup Language. 

Binding A particular mapping from a binding source to a binding target. 

Transformation A component supplied to the binding engine to transform data as 
15 it is transferred from the data source object model to the display page. 

Binding Definition The defirdtion of how to map data from the data source 
object model on to the DOM. It is a collection of individual bindings. 

Binding Engine The component that maps data from a binding source on to a 
binding target. 

20 CLSID Class ID Unique identifier for a COM object. 

COM Component Object Model. Microsoft-defined standard for binary 
interoperability of components. 

CSS Cascading Style Sheet. 

Data Reference A hierarchical name that refers to an object or property in the 
25 data source object model. 

Data Source A server system specific component that communicates with the 
server system and provides the data source object model to the binding engine. 

Data Source Connector The server system specific component on the display 
page that connects the display page to the data source manager. 
30 Data Source Definition The server system specific definition of the data required 

by the display page. This definition is understood by the data source and implicitly 
defines the shape and size of the data source object model. 
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Data Source Object Model An Automation object model containing data 
delivered from the server system. It is the source of data for the binding engine. 

Data Source Manager The component that coordinates the activity of the data 
source components and provides the execution environment for the binding engine. 
5 Display Page An HTML page that contains a data source comiector and one or 

more page elements. 

DTD Document Type Definition - used by an XML parser to validate that the 
structure of an XML document. 

HTA Hypertext Application - means of constructing a standalone application 
10 from a single HTML file. 

IE5: Microsoft Internet Explorer 5.0. 

Operator Framework: A user interface framework that allows an operator to 
interact efficiently and directly with the server system. 

Page Element: An element in the display page that has properties that can act as 
15 binding targets, (includes ActiveX Controls, HTML elements). 

Server System: A Honeywell system that is the ultimate source of data for a 
display page. These include PlantScape, TPS, OPC servers etc. 

VML Vector Markup Language - Microsoft's proposal for a standard vector 
graphics format for the Web. 
20 W3C: World-wide Web Consortium. 

XML Scriptlet: Method used to build small, flexible COM objects through a 
combination of XML and script code. A scriptlet may be thought of as a COM object, 
complete with properties, methods, and the capability of firing events. 

APP: Asynchronous Pluggable Protocol. 
25 BHO: Browser Helper Object. 

DSM: Data source manager. 

MFC Microsoft Foundation Classes. This is a C++ class library mainly used for 
creating WIN32 applications and can be used for creating ActiveX controls. 

ROT Running object table. 
30 Server System: A Honeywell system that is the ultimate source of data for a 

display page. These include PlantScape, TPS, OPC servers etc. 

VB: Microsoft Visual Basic. 
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Introduction 

Some preferred embodiments of the various aspects of the present invention are 
described in Australian provisional patent appUcation no PQ8087 that was filed on 
9 June, 2000. The disclosure in that apphcation is incorporated herein by way of cross- 
5 reference. 

It should be noted that the applicant's code-name for the embodiments of the 
present invention is "Hendrix", and this code-name therefore appears Ihroughout the 
provisional specification referred to above. While the same name is used in this 
specification, for the purposes of convenience and consistency, it is not intended that the 

10 invention be limited to any system having a particular trade- or code-name. 

Appendices A to E in the provisional application disclose the detail of various 
preferred embodiments of the present invention. It will be appreciated that the various 
discussions of development requirements and the like should be taken in the context of 
specific issues related to particular products supplied by the applicant, as well as being 

15 concemed with specific embodiments presently envisaged by the appUcant. 

Accordingly, the information in the appendices should be read as exemplary, and not 
restrictive of the broadest scope of the invention as described and defined in the earlier 
part of the provisional specification. 

To fiilfil the requirements of an industrial control user interface the preferred 

20 embodiments have been developed on the basis of the Hendrix architecture. In a broad 
form, it is a flexible, extensible architecture for the provision of real-time process data to 
a state-of-the-art user interface, using MSHTML as the underlying rendering engine. 

The Hendrix architecture provides a user interface that is suited to the demands 
and challenges of the next decade and which is designed to harness key industry 

25 standard technologies in an open, adaptable, architecture that facilitates the 

technological convergence of disparate HMI products. Some important technical 
features of the Hendrix architecture, as exemphfied in the preferred embodiments, 
follow. 

Open display page architecture — the Hendrix architecture separates the 
30 provision of data and server specific user interactions firom the implementation of 

individual page elements. The only real assumption made about a page element is that 
it is part of the HTML display page and accessible via the Document Object Model. 
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The provision of data to page elements and the association of server specific 
user interactions with page elements is handled by the Hendrix architecture. This has 
the important effect of widening the set of HMI page elements to include an34;hing that 
can appear in an HTML page. 
5 A further effect of this architecture is that Honeywell page elements are more 

easily reused in contexts outside of the Honeywell HMI for which they were originally 
conceived by virtue of the fact that they do not include any server specific 
implementation. These contexts include, for example, other Honeywell HMIs and non- 
Honeywell applications. 

10 Choice of runtime user environments — the architecture offers a choice of 

runtime user environments, reflecting the need for both controlled and casual access to 
process data. The first environment is a robust, secure operator environment, satisfying 
the distinctive requirements of industrial control user interfaces. The second is a web 
browser environment in which the user treats display pages as they would any other web 

15 page. Both environments utilize commodity third-party rendering engines to display 
process data. 

Open, extensible file format - the Hendrix architecture centres on a standards- 
based file format, using HTML as its foundation. The file format conforms completely 
to HTML standards, allowing display pages to be rendered by a third-party browser. In 
20 addition, the ubiquitous nature of the file format allows it to be edited in third party 
editing tools, in order to apply specialised fimctionality to display pages, such as 
complex path animation. 

Component-based architecture - the architecture is entirely component-based. It 
consists of both common components reusable by all Hendrix implementations, and 
25 server-specific components developed as part of each Hendrix implementation. 

Data delivery firom multiple sources — the architecture is designed to 
accommodate the delivery of data fi*om multiple Honeywell and other server systems to 
a single display. 

Single authoring tool, customisable for specific server needs — the architecture 
30 does not dictate how display pages are authored, provided they comply with the Hendrix 
file format standard. In the long term, and with the development of third-party tools, 
those tools should be sufficiently customisable to render them appropriate to this role. 
In the short-term, however, the preferred embodiments rely upon the specific 
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requirements of Honeywell industrial control systems and require a proprietary 
authoring tool. This tool utilises commodity third-party HTML editing components 
where appropriate. It is also extensible and customisable, such that it can meet the 
requirements of each server for which Hendrix is implemented. 
5 These features are schematically represented in Figure 1 . Note that this figure 

does not show all components of the Hendrix architecture and is intended to only 
provide an overview. Issues such as the binding of data from the server data source to 
HTML data, and the actual delivery of data, are discussed elsewhere in this 
specification. 

10 It is worth noting that the architecture does not necessarily dictate that all servers 

be capable of supplying remote data to their corresponding data sources. Some 
embodiments include one or more servers that satisfy themselves with server and 
middle tier (the data source manager and components) on a single machine. It will be 
appreciated that these embodiments still fall within the broader Hendrix architecture. 

15 Furthermore, the architecture provides, in some embodiments, remoting facilities to 
those components which require it. 

The preferred embodiments are designed to provide users with two ways to view 
and control plant information: the operator enviroimient, designed primarily for security 
and reliability, and the web browser environment, where universal, flexible, secure data 

20 access is the prime concern. The operator environment is aimed primarily at operators, 
and is intended to provide a firamework tuned to their needs, as follows: 

• Framework screen artifacts (menus, toolbars, command zone, alarm zone, etc.) are 
specific to the server system to which the firamework is connected. 

• Page navigation is simple and name-based (i.e. fiill URLs are not required for page 
25 navigation). 

• Provides explicit control of the connection to the server, able to specify screen 
update rates, connection types, and so on. 

• Guaranteed view of data via persistent alarm hne and status fine, if required. 

• Robust in the face of page failure - badly-behaved controls cannot compromise the 
30 operator framework. 

• Fast automatic fail over in redundant systems. 

• Able to be tailored to restrict operator's capabilities (e.g. prevent desktop access, 
prevent shutdown, fixU screen lock, SafeView, operator keyboard, etc). 
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• Secxire access to control of process parameters. 

The browser environment is aimed primarily at managers, engineers and process 
analysts, and is intended to provide a more regular web experience: 

• Navigation is via the normal hyperlinking mechanism, that is, full URLs are 
5 required for page navigation. 

• Connections to servers are implicitly created by "surfing" to a server. Connections 
use default parameters for things like update rates, connection types, and so on. 

• A user has the ability to easily "surf from system to system. 

• A minimal user interface is, in some embodiments, provided — depending on the 

10 system ~ for issuing commands. This user interface is not persistent and comes and 
goes with the page. 

• Server connections are cached (for a limited time) so that security levels are able to 
be maintained across pages. 

• Page URLs are selectively saved in browser favourites. 
15 • Menu and toolbars are the browser's menu and toolbars. 

• Controls on pages facilitate the control of plant data, as well as supplying context 
menus for issuing commands. 

• Fail over is not automatic in redundant systems 

The operator mntime environment, in the context of the Hendrix architecture, 
20 takes many forms in the different embodiments. These forms depend on the specific 
market and user requirements of each server type. For example, in one embodiment the 
runtime environment for one server consist of a single framework, complete with 
menus, toolbar and alarm zone. However, for another server it is a collection of display 
pages, organized on the screen through the use of a desktop management framework 
25 (e.g. SafeView). It is important to point out that in terms of the Hendrix architecture, 
these frameworks are identical. Data and commands are supplied to and from the 
framework in an identical manner, and display page management is the same. A thin 
layer differentiates the frameworks for different markets, but both systems fit into the 
Hendrix concept of the "operator framework". By way of example, one embodiment of 
30 the invention provides an operator runtime environment as illustrated in Figure 2. This 
is a PlantScape Hendrix implementation. However, in other embodiments use is not 
necessarily made of a PlantScape control but, rather, another Hendrix-compliant system. 
In this way Hendrix inherently provides a level of interoperability and convergence 
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amongst Honeywell HMIs. Note also that there is a distinction between the behaviour 
of Hendrix-compliant Honeywell controls and third-party controls. While these third- 
party controls are fully integrated into the Hendrix environment, they often do not 
possess some of the advanced functionality of Honeywell controls, such as quality 
5 indication. This additional functionality is provided by the architecture of the invention, 
in that appropriate configuration Hendrix supplied controls is undertaken to complement 
the existing third party controls. 

In other embodiments use is made of an altemative operator runtime 
environment, consisting of multiple display windows, positioned on screen through the 

10 use of desktop management soflware. Importantly both these runtime JBrameworks are 
equally valid Hendrix implementations. In fact, the invention was designed with 
altemative runtime frameworks in mind, as it recognizes that different market 
requirements require different user interface frameworks for different server products. 
This is one of the strengths of invention - that is allows the same underlying 

15 architecture to be used to produce extremely flexible, market-specific, user interfaces. 
This flexibility extends all the way to the web browser environment. In a Hendrix- 
based system, the web browser environment is able to display the same pages as those 
shown in, say. Figure 2, with live data updates. The preferred embodiments thus deliver 
the ability to view process data in a web browser. 

20 Figure 3 illustrates an overview of the display authoring that is utilised by the 

invention. The key points to note are: 

1. Displays are authored in a single, common authoring tool, and saved as standard 

HTML files. The definitions for the retrieval of data from various servers are 

saved in the file by the authoring tool. 
25 2. Users, where enabled, have the ability to add functionality to displays using 

commodity third-party HTML authoring packages. 
3. The display is then viewed, in either an operator environment or in a web browser. 

In both environments, the display behaves the same, with live data updates from 

the servers of interest. 
30 4. The data source manager - refer to Figure 1 - through server-specific 

components, manages the real-time retrieval of data from the servers of interest, 

and supplies this data to the displays on the chent. 
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This presumes a single authoring tool, with add-in components, for all systems 
in the embodiment to allow it to configure data for the various systems. In other 
embodiments, however, more than one authoring tool is used. Figure 4 illustrates, by 
way of example, an authoring environment that is provided in one of the embodiments 
5 of the invention. 

It should be noted from Figure 4 that the builder requires the ability to configure 
server-specific data access. The Hendrix HMI program allows the use of a single 
builder for industrial HMI products. In some embodiments, this builder is composed of 
server-specific components which allow this data configuration to take place. These 
10 components also allow the builder to be aware of issues such as server redundancy, data 
definitions, and server connection details. 

The preferred authoring tool is based around commodity third-party 
components, such as an HTML rendering engine for true WYSIWYG functionality. In 
other embodiments, however, use is made of commodity authoring packages that are 
15 sufficiently customisable to provide all the authoring fimctionality for Hendrix systems, 
and for the entire authoring tool to be a commodity item. 

Figures 5 to 1 1 illustrate various implementations of the Hendrix architecture, 
and scenarios in which those implementations are used. It is important to note that these 
scenarios serve to illustrate the area of interoperability between systems. This 
20 interoperability takes place on a number of levels: 

• At the control level, the interoperability between system controls is an inherit 
feature of the architecture provided by the preferred embodiments of the invention. 
The architecture fiilly supports binding process data to third-party controls, so by 
inference any Hendrix HMI supports controls from other Hendrix systems. In 

25 addition, controls built to be aware of the Hendrix architecture will be even further 
integrated into any Hendrix-based operator HMI. 

• At the runtime level, the architecture fully supports the integration of data from 
multiple data sources. Data from multiple HMIs is delivered to a single display 
page, resulting in excellent interoperabiUty between systems. 

30 • At the connection level, the abihty to establish a connection to a new server "on the 
fly" means the architecture provides a seamless transition between systems for both 
the casual user and the operator. 
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Another important point liiat is highlighted by the scenarios of Figures 5 to 1 1 is 
the degree of commonality between them. The Data Binding process common to all 
scenarios, for example, is provided by a generic binding engine component that is 
useable in any Hendrix HMI system. With such a binding engine implemented it will 
5 become available to all Hendrix implementers. Thus the Hendrix architecture delivers 
one of the most significant goals of HMI convergence and of component-based 
architectures in general: software reuse at the binary level. 

It will be apparent to the skilled addressee, from the teaching herein, that there 
are any number of user scenarios involving interoperabiUty between different Hendrix 
10 implementations. The main point to make is that such scenarios are possible, and 
facilitated by the Hendrix architecture. 

Benefits provided by the preferred embodiments 

The architecture provided by the invention and as manifest in the preferred 
embodiments, offers a large number of benefits to the operator and the designer of the 
15 systems. These benefits are at both a strategic and a technological level and can be 
broadly categorized into five main types: 

1 . Benefits arising firom the way the embodiments use commodity third-party 
technologies. 

2. Benefits arising firom the use of an open, industry-standard file format. 
20 3. Benefits associated with Hendrix data deHvery and data integration 

mechanisms. 

4. Strategic benefits. 

5. Benefits associated with "future-proofing" the industrial operator HMI. 
These five types will be considered in turn and in more detail below. 

25 Use of Commodity TItird-Party Technologies 

The architecture of the preferred embodiments, the Hendrix architecture, relies 
on commodity third-party technologies for a number of its core mechanisms. Where 
appropriate, these technologies and components provide functionality in areas which are 
not the core business of the system designer. This allows the designer to focus on the 
30 areas where they are able to add the most value, rather than trying to compete in areas 
that are not necessarily within their core competencies. The benefits offered by these 
technologies include: 
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• Casual access to process data via a web browser. This capability is important for 
non-operator users who do not wish, or who are unable, to install fat HMI client 
software on their machines. An important aspect of this capability is the ability to 
view the same display from a process environment in a web browser, not just the 

5 ability to publish process data on the web, 

• Unmatched intemationalisation features. With the combination of Intemet Explorer 
5.0 and Windows 2000, a Hendrix HMI is able to supply far richer 
intemationalisation features than those currently available in existing HMI systems, 
such as dynamic language switching, changing language mid-line, and rich third- 

1 0 party intemationalisation tools. 

• State of the art graphics rendering. The rendering engine provided by MSHTML is 
one of the best available, functionally more capable than any existing product, and 
likely to continue to improve as the intemet expands. Its aiiimation capabilities and 
ability to render highly-demanding images such as 3D graphics, will prove difficult to 

15 match in the coming decade. This is more of an advantage in a non-console operator 
environment. The console operator environment is an area where the elements of the 
display must be as non-distracting as possible, allowing for operators to carry out their 
normal pattern-recognition and action tasks. One example of the application for 3D 
rendering would be visualisation of blast furnace arrays and the displaying of hot 

20 spots in the furnace in 3D. [Note that "advanced graphics rendering" should not be 
seen as limited to such advanced functionality as 3D rendering. The rendering 
capabilities of MSHTML include the ability to render different graphics formats, such 
as JPG and GIF files, and any future graphics formats that come available.] 

• Easy display deployment. Hendrix systems allow leverage to be gained from 

25 standard deployment mechanisms available to browsers, which are becoming richer 
as the industry progresses. An example is the 7/24 availability (7 days a week, 24 
hours a day) demanded in modem web servers, which now provide advanced 
display replication capabilities to meet these demands. 

• User-definable operator frameworks. Technologies such as Microsoft's Hypertext 
30 Application (HTA) technology facilitate the development of user-definable operator 

frameworks, which are accommodated within the Hendrix architecture. This 
capability, while primarily intended from use by the designer of the architecture, is 
in some embodiments also provided to the users or customers of the system. 
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• Easy generation of displays dynamically. Standard web technologies such as Active 
Server Pages can be used to generate displays on the fly. Depending on different 
requirements such as operator capabilities (high-contrast displays for some 
operators, for example), or daily activities (different displays to reflect different 

5 schedules on an oil pipeline) can result in different displays being built on the server 
and sent to the cUent. Other examples include the abiUty to generate system 
management displays dynamically using standard mechanisms. 

• AbiUty to integrate with standard value-add offerings for intemet products, such as 
e-mail integration objects, transaction components, and messaging components, that 

10 come as standard parts of state of the art web server products. 

Industry-Standard File Format 

The preferred embodiments are centred aroimd an open, extensible, industry- 
standard file format. Particularly, use is made of a file format in as standard an HTML 
representation as possible, thus reaping the most benefits firom the alignment with 
15 industry standards. The use of this file format brings a number of benefits, including: 

• Third-party authoring tool options. The use of a standard file format results in 
multiple options for authoring tools, particularly in the area of round-tripping 
displays. Where a designer's standard authoring tool does not offer the capabilities 
required by a particular customer, such as complex path animation, tliis functionality 

20 is supplied by editing the Hendrix display page in a third-party HTML editing tool. 
The ability to edit a designer's display in a third-party authoring tool offers 
unprecedented flexibility to the user of the system. 

• Leveraging of existing knowledge. Using both an industry-standard scripting model 
and industry-standard file format means customers are able to gain leverage firom 

25 the rapidly growing pool of expertise in web authoring, graphic design, and HTML 
scripting to produce high-quaUty process displays. Users of the system provided by 
the invention are able to selectively, and as required, use their favourite graphic 
design team to design their displays, rather than relying on the overall system 
designer for their look and feel. 

30 • The use of a common file format facilitates re-use of displays between different 
systems, thereby helping to protect a user's intellectual property investment. 
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• Display pages are machine-searchable and human-readable. This aspect of the 
Hendrix architecture has a number of benefits, including: 

o The ability to facilitate automated cataloguiag aad searching of displays by 
customer systems, software applications provided by the provider of the 
5 system, and third-party tools. 

o Simple text search and replace functionality external to the bmlder itself. 

o Configuration management: the text-based nature of the file format renders 
it suitable for use in configuration management systems. 

o Custom manufacturing of standard system displays prior to shipping, 
10 o Ability to preserve user additions to the system displays through the process 

of an upgrade — customisations of system displays can be positioned along 
the lines of a macro that alters the system displays, rather than modifications 
that must be performed on each revision of the displays. 

• Easier conversion to/from industry standard fomiats (for example, AutoCAD, 

15 PowerPoint) into system displays. In many industries, displays are first created in 

AutoCAD, and then have to be transformed to proprietary formats. The adoption of 
HTMLATML as the file format makes this conversion simple. 

• Powerful template mechanism through the use of Cascading Style Sheets (CSS). 
The CSS mechanism provides users of the embodiments with the capability to apply 

20 style to entire suites of display pages. Examples of this functionality includes: 
o Changing backgroimd watermark for an entire set of system displays, 
o Updating one or more icons used on every display to reflect changed 
company logo. 

o Choice of colours to reflect particular customer and/or operator 
25 requirements, applied across the entire set of displays. 

o On a ship system, the ability to supply full-colour displays by day, and red- 
on-black by night. 

o Altering displays according to operator requirements, such as colour 
blindness. 

30 • Abihty to add user-definable stractured data to display pages. Current standard for 
this capabihty is throu^ the use of XML. A user is in a position to add customer- 
specific fields that track changes made to that display. This structured data is 
usually stored in the file and made available via scripting. This functionality is 
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immediately accessible by the user simply through the choice of Hendrix file 
format. With a proprietary format, the system designer or operator would be 
required to implement this functionality on a case-by-case basis. 
• The industry-standard file format protects customer intellectual property against 
5 technological change. With a proprietary format, the operator is responsible for 
migration and iacompatibility issues when new file formats are adopted. These 
issues still exist in the case of HTML, but the user base of this file format is far 
larger. While the problem is not completely removed, the risk of inadvertence is 
reduced as the number of minds made aware of the issue is far larger. 
10 • Additional enhancements to web file format standards are delivered for firee. 

Examples of this support - which will be handled by the MSHTML rendering 
engine - include Scalable Vector Graphics (SVG) from the W3C, and Extensible 
3D (X3D) from the Web3D Consortium. 

Data Delivery and Integration 

15 The Hendrix architecture is designed for rich data integration capabilities, which 

bring with them the following benefits: 

• Ability to integrate data from multiple operator or provider systems on a 
single display. 

• Facilitation of remote operation. The capability of remote data binding 
20 realises the possibility of a thin-client architecture on every system. 

The Hendrix client is then completely scalable, and suited for 
environments from hand-held PC devices, through to wearable 
computers produced by HTC, all the way to workstations and servers. 
The architecture expands the reach of the user interface like no existing 
25 HMI. 

• Seamless integration of foreign data sources via the standard HTML 
data binding mechanism. Information from Oracle, SQL server, or 
even structured data in the form of XML is incorporated into the page, 
as required for the particular application. Foreign data is used in some 

30 embodiments to drive some properties of an object on a page, while in 

other embodiments use is made also of process data. No ActiveX 
controls are required for this data binding — it takes place natively 



wo 01/95041 



PCT/AUOl/00706 



-22- 

within the engine itself - and can be bound directly to HTML elements 
such as tables. 

• Better integration between the operator HMI and other business 
systems. Business systems are undoubtedly moving towards greater 

5 integration with the web, which brings the Hendrix HMI closer to those 

systems. The inherent web integration of the architecture, along with 
native HTML data delivery and data binding, provide a rich means for 
integrating business system information - such as order information in 
a manufacturing facility, or web-based corrective action applications - 
10 into the operator HMI. 

Another related aspect is the trend amongst device manufacturers to provide the 
abihty to configure their devices (such as terminal servers or printers) using web-based 
user interfaces. The preferred embodiments allow the user to configure all the devices 
in their system through a single user interface. 

15 Future-Proofing 

The Hendrix architecture is designed to protect the HMI from technological 
change, placing it in a good position to weather changes in the future and thus extending 
its shelf-life. The term "fixture-proof is, of course, a misnomer. No product is able to 
insure itself against fixture technological change, no matter how advanced it may be, 

20 unless it is able to continually evolve with these changes. Some products, however, are 
better placed to adapt to change, by virtue of their architectures. It is in this area that 
Hendrix offers its advantages, as explained below. 

Note also that "fixture-proofing" has been a promise of previous architectures, but 
in the past has proved to be an elusive goal. The fixture-proofing offered by the Hendrix 

25 architecture is more extensive than simply the xxse of the latest soflware tools, or the 
introduction of open systems. The Hendrix architecture is unique in several areas: 

• It uses commodity third-party components (such as MSHTML) to 
harness the power of technological change that the internet represents. 
Standards change, new ones arise, and new technologies become 

30 available as the internet develops — and Hendrix is design to grow v^th 

them all. New technologies will become available almost by default, 
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and new tools will offer capabilities beyond the scope of any one 
organisation's development teams. 

An operator or designer of the system of the invention has no need to 
develop a world-class ActiveX control container, for example, when 
one already exists. The Intemet Explorer engine is a control container 
par excellence, and is guaranteed to adapt to upcoming technological 
developments. For example, Microsoft has already demonstrated the 
next-generation control capabiUties slated for Visual Studio 7 (code- 
named "Rainier"), featuring unprecedented integration between 
controls and their container. This functionality is already supported by 
Intemet Explorer 5.0, and would come for free in the architecture 
provided by the preferred embodiments of the invention. 
One way to view this is that whenever Microsoft raises performance 
expectations in its own products, any ActiveX control container of our 
own is expected to do the same. By using their components directly, 
each improvement they make instead turns into a direct benefit for the 
system operator and, hence the user. There is a direct flow on effect of 
the technology as extensive redesign is not required to incorporate the 
new features. 

It is component-based, and thus extremely versatile and able to adapt to 
change. When new system features become available (for the data 
binding, authoring, or rendering, for example), only the affected 
components need to be replaced, not the entire system. 
It adds the operator's value to precisely those areas suited to their 
needs, addressing requirements specific to industrial control systems, 
thus ensuring the viability of the operator's products in the long term. 
Hendrix implementations are not threatened by new user interface 
technologies, but assisted by them. For example, as commodity editing 
components and tools become available, the operator simply picks up 
the fimctionahty of the authoring tool, as appropriate. With prior 
proprietary systems, this option is clearly not available where the 
equivalent fimctionahty had to be built into the authoring tool by the 
operator, usually at a great cost. 
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• It is closely coupled with industry standards - not just Microsoft 

technologies referred to above - and is designed intentionally to be open 
and extensible. The standards-based nature of the architecture helps 
protect the architecture, wth bodies such as the W3C working to ensure 
5 that internet development is an incremental and evolutionary process. 

As previously mentioned, no product is future-proof. The Hendrix architecture, 
however, is designed to be far more adaptive to change than any existing HMI system. 

The Hendrix Architecture Overview 

The Hendrix architecture describes the components and relationsliips between 

10 them necessary to build a fully functional industrial HMI. The architecture provides the 
infrastracture for the run time support of HMI display pages and frameworks in which 
to view, navigate and interact with them. 

The Hendrix architecture is an entirely component-based architecture in which 
each component in the architecture is a COM object. This approach means that the 

15 architecture is easily partitioned into standard components that are used in all Hendrix 
implementations and server specific components that must be implemented for each 
server system for which the Hendrix architecture will act as an HMI. 

The foxmdation of the Hendrix architecture is Microsoft's core HTML rendering 
component known as MSHTML. This component forms the basis of an increasing 

20 number of Microsoft products including Intemet Explorer, Outlook Express, Money98, 
MSDN Library, Microsoft Management Console and others. It takes the form of a 
reusable COM object that is available to independent software vendors, such as 
Honeywell, for use in third party products. The latest version of MSHTML, which 
forms the basis of Intemet Explorer 5, is positioned by Microsoft as an application 

25 development platform to rival MFC in terms of performance and stability. In addition, 
the latest version of MSHTML includes many new features that are pivotal in making it 
suitable as a basis for an industrial HMI architecture such as the Hendrix architecture. 

MSHTML provides the following HMI capabilities in the Hendrix architecture: 
display file parsing and rendering; ActiveX control hosting; scripting; 2D graphics 

30 primitives (VML); and multimedia and animation services. 

With MSHTML as its foundation, the Hendrix architecture, as implemented in 
the preferred embodiments, achieves two broad goals. The first is to add the 
mechanisms necessary to turn MSHTML into an industrial HMI. The second is to 
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structure these mechanisms in such a way as to faciUtate convergence amongst the 
various operator HMI products. By adopting the Hendrix architecture the operator is 
able to implement a common HMI framework for its various industrial process control 
systems which minimise development effort, maximize interoperability of components 
5 between systems and, importantly, give customers a consistent suite of user interface 
tools with which to operate and manage their plants. 

To turn MSHTML into an industrial HMI it is necessary to provide mechanisms 
for data delivery, user initiated commands, navigation, robustness and stability. These 
mechanisms must be available to different classes of users in user interface frameworks 

10 that reflect the needs of each class of user. The personnel that operate the system on a 
day to day basis require a framework with menus, toolbars and guaranteed access to 
alarm and status information. On the other hand, managers of the personnel need more 
casual access along the lines of a regular web browsing experience. 

With these mechanisms in place, the Hendrix architecture allows the designer 

15 and provider of the system to concentrate on adding value to its HMI in the fomi of 
specific display page elements (typically ActiveX controls) that allow users to more 
effectively interact with and manage both their plant processes and the systems used to 
control them. The preferred embodiments of the invention also make these controls 
very easy to write. 

20 The three main components in the Hendrix architecture are the MSHTML 

display page containing a number of display page elements and a small number of 
infrastructure components, the Hendrix data source manager which contains a number 
of server system specific data source components and the Hendrix binding engine which 
transfers data and commands between the data source components and the display page 

25 elements. Figure 12 illustrates the general arrangement of these components. 

The data source manager used in the preferred embodiments is a resource shared 
by all display pages on the client machine and each display page has its own binding 
engine. Data source components are also shared by binding engines, although this need 
not occur in all instances. Figure 13 illustrates a data source manager that is used in a 

30 preferred embodiment of the invention. 

The MSHTML based display page acts as the container for the page elements 
that make up the display and provides the primary user interface thread of execution. 
The page elements, in some embodiments, include Honeywell ActiveX controls, third 
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party ActiveX controls, VML graphics elements, HTML elements, HTML scriptlets, 
Java Applets etc. In fact, anything - control, element, or otherwise — that can be 
included in an HTML jSle counts as a page element in the Hendrix architecture. 

The display page is constructed using a mixture of standard HTML and Hendrix 
5 specific XML tags. The HTML describes the presentation aspects of the display page 
(that is, the page elements) while the XML tags are used to describe what data is 
required for the page and how that data is to be appUed to the page. 

The display page also contains a small number of Hendrix infrastmcture 
components that assist with the parsing of the XML content of the display page, the 
10 delivery of data to the display page and the initiation of server commands from display 
page elements. 

At run time the display page appears as an instance of the industry standard 
Document Object Model (DOM). This object model provides the destination for data 
provided by the Hendrix data binding engine and provides the basis for the display page 
15 scripting environment. 

Display pages are preferably encapsulated for reuse. This encapsulation 
includes the parameterisation of any data references in the display page and the addition 
of properties, methods and events that allow the encapsulated display to act as a fully 
fledged component. Encapsulated displays are usually either embedded or linked into 
20 containing display pages. 

The data source manager is the component that co-ordinates the delivery of data 
from the various server systems to the Hendrix arcliitecture. The data source manager 
manages a series of server system specific data source components that encapsulate the 
details of delivering data to and from particular server systems. Data source 
25 components are required for Plantscape, TPS, TP A, QCS, Uniformance, OPC and HCI. 
Each data soiirce component presents data from a server system in the form of a 
hierarchical object model. 

The data source manager pulls the separate data source component object 
models together into a unified data source object model that is xxsed as the source of data 
30 for the Hendrix binding engine. 

The data source components are informed of the data requirements for a 
particular display page by means of a data source definition that is stored as part of the 
HTML/XML display page file. The details of the data source definition is a data source 
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component implementation detail. The data source definition is usually the result of a 
"pre-binding" mechanism that turns the human readable data references used in the 
display page into machine readable names that pro^dde for more efficient deliveiy of 
data at run time or it may simply define the extra information required to deliver the 
5 required data such as update rates aiid the like. 

Data source components are used to optionally support indirect data references 
where an item in the data source object model is used as a place holder for particular 
objects in the server system which are specified at run time. This provides a level of 
indirection in the data source that is used to 'T^rowse" through objects of the same type. 

10 The preferred data binding engme takes the data provided by the data source 

object model and applies it to the display page. It does this in a way defined by binding 
definitions contained in the HTML/XML display page. Each display element that 
requires data has an associated binding definition that defines what data is required for 
the element and how it is to be applied to the element. 

15 A key feature of the data binding engine of the preferred embodiments is that it 

is able to bind data to any property of the DOM. This includes the body element and 
any container elements that are used to organise other elements on the display page. 

The architecture of the binding engine is component based and uses 
"transformations" to perform the traasfer of data from the data source object model to 

20 the display page. These transformations aUow the transfer of data directly or transform 
it some way as they transfer the data. Examples of where transformations are used 
include user written "OnDataChange" scripts and data driven page element "dynamics" 
such as rotation, path animation and break point animation. Transformations are 
preferably either binary components or written using and XML syntax and script code. 

25 The binding engine executes in an apartment managed by the data source 

manager and transfers data from the data source object model to the display page in a 
very efficient manner. 

Each server system for which the Hendrix architecture is acting as an HMI has 
its own set of commands that a user may need to invoke. These include coimnands 

30 directed at the process such as "raise" and "lower" or at the server system itself such as 
"acknowledge alarm" and "point detail". 

These server specific commands are implemented as methods on the root object 
of each server specific data source component. These commands are executed from 
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page based script code or from server specific *T)ehavioiirs" associated with display 
page elements. 

In addition there are system wide commands that apply across server systems 
such as commands to log on to the system or change security levels. These commands 
5 are implemented as methods on the root of the unified data source object model 

provided by the data source manager. Again, these commands are executable from page 
based script code or from a behaviour associated with display page elements. 

In many circumstances it is necessary to allow users to view display pages 
within some framework that makes the task of viewing, navigation and interacting with 
10 display pages easier and safer. Examples include the Plantscape Station framework 
(that provides a menu, toolbar, alarm zone, status zone, message zone and command 
zone), the Safe View (which provides window management for multiple displays) and 
the TP A framework (that allows the user to easily navigate between displays). 

The Hendrix architecture itself provides a mechanism for constructing a user 
15 interface framework. This is achieved by constructing the fi^amework as a series of 
display pages that manage other display pages. It is easy to construct frameworks that 
contain the usual user interface elements such as menus, toolbars, status lines as well as 
HTML constructs such as framesets. This makes the repertoire of possible frameworks 
very large indeed. 

20 Hendrix based frameworks in conjunction with SafeView provide a flexible, 

powerfiil and safe means of delivering the environments needed by users to more 
effectively use an HMI. 

At run time a Hendrix display page is an instance of the industry standard 
Document Object Model (DOM). The DOM contains instances of useftil display 

25 elements such as ActiveX controls, HTML elements, graphics primitives etc. The 
DOM is initialised from an HTML file that specifies the initial content of the display 
page and is created by an authoring tool such as the Hone)well Coimnon Display 
Builder. An HTML parser parses the HTML file and initialises the DOM. A rendering 
engine then renders the DOM in a window. Hendrix uses Microsoft's MSHTML 

30 component for these fimctions. Figure 14 illustrates the general arrangement of the 
main display page components. 

Once initialised, the page is updated v^th data from the Hendrix data binding 
engine upon which the HTML rendering engine re-renders the display page so that the 
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user sees the changes to the page (this re-rendering behaviour is what is conmionly 
known as 'T)ynamic HTML" or DHTML). The flow of data between the data binding 
engine and the display page is typically bi-directional. Any changes made locally to the 
display page, by the user or by script code, are re-rendered by the rendering engiae and 
5 propagated back through the data binding engine. 

In addition to the presentation aspects of the display page defined using HTML 
there are Hendrix specific XML tags in the display page file that define the details of 
what data is required by the display page and how to apply that data to the display page. 

The details of what data is required by the display page are contained in a series 
10 of data source definitions. There is one data source definition for each type of data 
source component (that is, each type of server system) firom which data is required for 
the page. The details of the data source definition are specific to each type of data 
source component. 

The details of how to apply the data to the page are contained in a series of 
15 binding definitions. There is one binding definition for each page element that requires 
data fi-om the server system. 

The display page also contains a data source connector that establishes 
communication with the data source manager. The data source connector also plays an 
important role in transferring data fi:om the data binding engine of the preferred 
20 embodiment and in providing "named data access". 

The display page contains components that assist with the parsing and 
processing of the XML portions of the display page file. 

The display page file is completely managed by a common display builder 
which, in this embodiment is proprietary software developed by Honeywell. This 
25 software produces and maintains both the HTML and the XML content of the file. 

The split between the HTML and XML portions of the display page file 
corresponds to a split between the presentation and content aspects of the display page. 
Since the presentation aspects of the display page are expressed in standard HTML, 
third party tools can manipulate the presentation to provide functionality not provided 
30 by the common display builder. Because third party tools will not imderstand the XML 
portions of the display page file the data source definition and the binding definition will 
remaia opaque to those tools. 
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The immediately following description deals with the basic display page 
HTML/XML file fonnat, while later description discusses the data soiirce definition and 
binding definition in detail. 

The following example illustrates a very simple Hendrix display page that 
5 contains a single page element. 

<HTML> 

1 <xml:namespace ns="um:schemas-hone)well-com:hendrix" 

prefix="HENDRIX"/> 



10 2 <OBJECTID="Data"CLSID="..."XOBJECT> 

3 <OBJECT ID="HendrixExtensions" CLSID="..."x/OBJEC'I> 

4 <OBIECT ID="HendrixExtendedElement" CLSID="..."><yOBJECT> 

5 <OBJECT ID=^'PlantscapeCommands" CLSID="..."></OBJECT> 



15 <STYLE> 
6 

url(#HendrixExtensions)} 
7 

url(#HendrixExtendedElement)} 
20 8 

url(#PlantscapeCommands)} 

</STYLE> 



HENDRIX\:* {behavior: 
.Hendrix {behavior: 
.PlantscapeCommands {behavior: 



<BODY> 

25 9 <SPANID="Alphal"CLASS="Hendrix; 

PlantscapeCommands" BINDINGDEF="AlphalBindingDef'> 

</SPAN> 

10 <HENDRIX:BINDINGDEF ID="AlphalBindingDef'> 

<DATA ID="DataRefl" 

30 REF="OPC.Modbus.A100.PV"/> 

<BINDING SOURCE="DataRefl" 
TARGET="PageElement.InnerHTML"/> 

</EIENDRIX:BINDINGDEF> 
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<BODY> 



11 



<HENDRIX:DATASOURCEDEF ID="OPC' 



CLSID="DA943720-8048-lld2-8ED5-000000000000"> 



5 



<SERVER NAME="modbus"> 



<GROUP UPDATEPERIOD="500"> 



<ITEM NAME-"A100.PV"/> 



<GROUP> 



<SERVER> 



10 



<;/HENDRIX:DATASOURCEDEF> 



</HTML> 



The file begins with an XML namespace declaration that establishes the use of 
the Hendrix namespace in this file (1). This step is followed by the data source 

15 connector (2) and the two components that assist with the processing of the XML 
content of the page (3 and 4) and a component that implements Plantscape command 
behaviour (5). A STYLE block is used to associate convenient names with the 
infrastructure components (6,7 and 8). The body of the display page then contains a 
single HTML element (9). This SPAN element has a binding definition associated with 

20 it (10). This binding definition specifies that the data item OPC.ModbusA100.PV is 
bound to the LmerHTML property of the SPAN element. Finally, there is a data source 
definition for the OPC data source component (1 1) that specifies the details of how to 
get the item A100.PV fi-om the OPC server called Modbus. 



25 other embodiments, where the display page requires data firom more than one server 
system, there are data source definitions for each type of server system. 

The most commonly used categories of display page element are ActiveX 
controls, VML graphics elements and HTML elements. As mentioned elsewhere, the 
ActiveX controls are either or both of Honeywell or third party controls. VML graphics 

30 elements include built in simple shapes such as rectangles, lines, ellipses, arcs etc or 
more complex shape types. HTML elements include the fiiU suite of normal web page 
elements such as DIV, SPAN, IMAGE, TABLE, INPUT, OPTION, SELECT etc. 



Note that in this example there is only one data source definition in the file. In 
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The architecture of the invention, as provided in the preferred embodiments, 
allows this wide variety of display page elements to be treated equally with respect to 
supplying data to them jfrom server systems. This is achieved by the binding engine 
assuming most of the responsibility for transferring data from the data source 
5 components to the display page elements. The display page elements simply have to 
offer properties to which data can be delivered. A similar situation exists with respect to 
server and system command behaviours. Command functionality is added to page 
elements by the Hendrix architecture without the behaviour having to be expUcitly 
coded into the elements themselves. 

10 This effective separation of presentation, content and behaviour in the Hendrix 

architecture means it is easy to write ActiveX controls that work well in the Hendrix 
architecture. Most controls do not need to worry at all about how data is supplied to 
them or how command behaviours are associated with them. The control designer is 
free to concentrate on the presentation aspects of the control which makes the task of 

15 designing controls much simpler. This also makes the system incredibly robust. 

There are, however, a small number of requirements that ActiveX controls used 
as Hendrix page elements must meet to be fully integrated into the Hendrix architecture. 
These fall into two main categories: requirements that make the controls "Hendrix 
compatible" and requirements that make the controls "Hendrix aware", 

20 The first requirement of Hendrix compatible controls is that they provide 

property change notifications if they are to write changed values back to the server 
system. This is because the binding engine uses these notifications to know when to 
send a new value back to the data source object model. This corresponds to the 
properties of the element being marked as [bindable] in the element's type library. 

25 A page element property that is bindable may support optimistic binding or 

pessimistic binding. Optimistic binding means that the element will simply notify the 
binding engine that the property has changed, after which the binding engine will 
propagate the new value back to the binding source in the data source object model. If, 
for some reason, the value cannot be changed on the server system, for security reasons 

30 perhaps, the data source object model will need to notify the binding engine that the 
value has changed back to the previous value and have the binding engine propagate 
that value back to the page element. 
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In the case of pessimistic binding the page element will ask the binding engine if 
the property value can change. The binding engine forwards this request on to the 
binding source where security considerations etc. can be checked. If the value can be 
changed the page element then changes the value and notifies the binding engine. If a 
5 page element supports pessimistic binding its properties will be marked as [bindable, 
requestedit]. 

The Hendrix architecture supports both types of binding. If a property of a page 
element does not support either type of binding it can only be used for read only data. 

The other requirement of a Hendrix compatible control that allows complete 
10 integration in the Hendrix architecture is that the control be windowless so that 

command behaviours are associated with the element. If the element has a window, for 
example an ActiveX control that does not conform to the OC96 specification, the 
command behaviour will not receive user input. 

Note that page elements that do not meet these requirements are still usable in 
15 the Hendrix architecture, but they will suffer jfrom the two limitations noted above. 

Hendrix aware controls are controls that know about the Hendrix architecture 
and that use it to their advantage. An example is a trend control that knows how to 
interact with the data binding engine to access more historical data as the user scrolls the 
trend. Another example is a combobox control that directly request the deUvery of its 
20 list only when the user cUcks on the control to drop the list down. 

Another important aspect of Hendrix aware controls is that they are designed 
with properties that correspond to properties on the server supplied data source object 
models so that the binding of data to the control is as direct as possible and hence as 
efficient as possible. 

25 In short, Hendrix aware controls are the controls that work best with the Hendrix 

architecture. Non-Hendrix aware controls are still usable in the preferred embodiments, 
but may require small amounts of script code to effect full integration. 

The Hendrix architecture encapsulates the mechanisms used to communicate 
with a server system at run time. These mechanisms include the deUvery of data to the 
30 Hendrix architecture and the routing of commands back to the server system, 

A Hendrix data source is a component that encapsulates a server system at run 
time. It consists primarily of data reference objects that encapsulate the details of 
dehvering particxdar data items firom the server system. The data references are 
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organised into a data reference object model, which is used by the Hendrix data binding 
architecture as input. The data reference object model is also accessible by display page 
script code and Hendrix transformations. The data reference object model also provides 
the means by which commands are routed to the server system. Commands are 
5 implemented as methods on data references within the data reference object model. 

The delivery of data from a server system involves many server system specific 
details. For this reason data sources need to be developed for each type of server 
system. Even within a single server system there may be different types of data items 
that are delivered in different ways which means data reference objects need to be 

10 developed for each type of data item in each server system. 

The data source manager is the Hendrix component responsible for coorduiating 
the delivery of the data required by display pages. It manages both the server system 
specific data sources and the bindmg engine that transfers the data from the data source 
components to the display page. Figvire 15 illustrates the general arrangement of these 

15 components. 

When a display page is called up, the data source manager accepts URLs for the 
data source definitions and binding definitions from the data source connector on the 
display page. It parses the data source definitions and instantiates the necessary data 
sources. It then passes the data source definitions to the data sources so that they can 

20 constract their data reference object models. The data sources then pass references to 
their individual object models back to the data source manager which then makes them 
available to the binding engine together with the binding definitions for the page. The 
binding engine then binds the data references in the data reference object models to the 
display page according to the binding definition. The data sources are then instructed 

25 by the data source manager to begin delivering data. 

A Hendrix data source implements a memory resident hierarchical data 
reference object model. This object model consists data reference objects. These data 
reference objects provide the means by which data from the underlying server system is 
presented to the Hendrix architecture. 

30 A data source appears as in-process COM object to the data source manager. In 

order for a data source to be usable on a machine ofiier than the server system itself it 
must include a mechanism for populating its object model over the network. The 
mechanism to do so is an implementation detail of each data source. 
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The main task of a data source is to provide an initialisation service to the data 
source manager. This initialisation service allows the data source manager to pass a 
stream containing a data source definition to the data source. This data source definition 
contains the information necessary for a data source to construct and initialise its data 
5 reference object model. Once initialised, the data source returns the root of its object 
model to the data source manager. 

The data reference object model is used as input to the Hendrix data binding 
engine. However, before the binding Gngine transfers data to the display page it needs 
to bind to the data references. It does this according to a binding definition associated 

1 0 with the display page. 

Once the data source has been initialised and the binding engine has boxmd to its 
data references, the data source will be started so that it connects to the server system 
and begins delivering data to the data binding engine. The delivery of data is actually 
performed by individual data references. 

15 When the data references are no longer required the data source is stopped and the 

data source closes any connections it has with the server system. The binding engine then 
release all data references. The data source manager will uninitiaUse the data source 
during which the data source will discard its data reference object model. The data source 
manager usually caches a data source in the imimtialised state for future use. 

20 There is a one-to-one relationship between display pages and data sources. A 

data source will only ever be supplying data to a single display page. The one data 
source manager, however, is able to supply data to multiple display pages. In this case 
the data source manager is managing multiple data sources for multiple display pages. 
These multiple data source instances may make use of shared resources for 

25 commxmicating with the server system. This sharing of data includes the sharing of 
physical network connections and the consolidation of data delivery to avoid the 
duplicate transmission of data that is common to multiple display pages. This behaviour 
is a data source specific implementation detail. 

A key concept in the Hendrix data delivery mechanism is that of the data 

30 reference. A data reference is an object that refers to a named data item in a server 
system. A data reference encapsulates the details of deUvering the data to which it 
refers firom a server system to the Hendrix architecture. 
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A data reference typically augments the name of liie referenced data item with 
the additional information required to affect the deUvery of the data item. This 
additional information includes one or more of update rates, time intervals for historical 
data, additional query parameters and the like. 
5 Data references deliver data to the Hendrix architecture via property change 

notifications, OLE DB rowset notifications and events. 

A data reference has the following basic structural elements: 

1 . An ID by which it is known to the Hendrix architecture. 

2. An associated name fi*om the server system namespace which identifies 
10 the data item to which the data reference refers. 

3. One or more properties, OLE DB rowsets, methods and/or events that 
represent the referenced data item to the Hendrix architecture. 

4. A set of properties that define the additional information required for the 
delivery of the referenced data item (also known as data delivery properties). 

15 The ID is a read only property. The data reference ID is largely aa internal 

name for the data reference and is rarely seen by end users. 
The name is optionally a read/write property. 

Since the ID of the data reference and the name to which it refers are separate 
properties, a data reference provides a natural form of indirection. If the associated 
20 namespace name is changed at nmtime, the data reference then refers to a different data 
item in the server system. This runtime indirection is an optional property of data 
references that is difficult to implement in some cases. If so, it is easily disabled by 
simply making the name property read only. 

The set of properties, methods and events that represent the data item to the 
25 Hendrix architecture (and can be bound to display page elements) depend on the type of 
the referenced data item. In many cases a single property that represents the value is all 
that is necessary. The value property is typically the default property on the data 
reference. This makes the syntax for accessing the value slightly more compact. 
A slightly more complex example is provided by data items that have an 
30 associated quality indication. In this case, the data reference includes a property for the 
value (the default property) and a property for the quality indicator. 

The data dehvery properties are read only or read/write properties depending on 
the capabilities of the server system. Again the specific set of properties required 
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depends on the server system and the type of the referenced data item. The data 
delivery properties include properties that control the transmission of data from the 
server system such as update rates or information that helps to completely identify a 
data item in cases where a name from a server system namespace is not sufficient. 
5 The following example ftirther illustrate the basic data reference concept and its 

practical implementation. 

Consider a data reference that refers to an item in a Plantscape server called 
"34FC1234.PV\ The data reference's ID might be ParamRefl and the associated 
namespace name would be "34FC1234.PV", Figure 16 illustrates a data source with 
10 several data references. 

The Hendrix architecture knows the value of the referenced data item as 
ParamRefl (or ParamRefl .Value). If the data item includes a quahty indication the 
Hendrix architecture knows it as ParamRefl .Quality. 

Script code for changing the namespace, in some embodiments, takes to 
15 following form: 

ParamRefl .name = "34FC2222.PV" 

As far as the Hendrix architecture is concemed nothing has changed, the data 
reference ParamRefl is still supplying data, but behind the scenes it is now getting data 
from another item in the Plantscape server. Of course, this implies that the new data 
20 item in the server is of the same type as the previously referenced data item so that the 
same data reference object is used to reference it. 

Data references are also organized in a hierarchy if this better reflects the 
structure of server system data. A hierarchical organization allows multilevel 
indirection to occur. 

25 The following example shows how hierarchical data references in an LCN data 

source provide multilevel indirection. Consider two data references that refer to 
different parameters of the same tag in an LCN system. ParamRefl refers to 
"AlOO.PV" and ParamRefZ refers to "AlOO.SP". Figure 17 illustrates this example. 

Where the desired effect is to change both of these data references to look at the 

30 same parameters of another tag, "A200", the namespace name of both data references 
could be changed as above to refer to "A200.PV" and "A200.SP" respectively. 
Alternatively, and as implemented in some embodiments, a separate data reference is 
used for the tag name called TagRefl that initially refers to "AlOO" with ParamRefl 
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and ParamRefZ now referring to 'TV" and "SP" respectively. The Hendrix architecture 
then knows "AlOO.PV" and "AlOO.SP" as TagReflJaramRefl and 
TagRefl .ParamRef2. 

The following script code is all that would be required to change the references 
5 from "A100.PV" and "AIOO.SP" to "A200.PV" and "A200.SP". 

TagRefl .name = "A200" 

It is up to the data source to make sure that all data references below TagRefl 
now refer to the correct parameters in the server system. 

Another common application of hierarchical data references is when a data 
10 source provides data from multiple server systems simultaneously. An example of this 
is an OPC data source. Li this case a data reference refers to the server and data 
references that refer to the items within the server would appear as children of the server 
reference. The associated namespace name for the server reference is, for example, the 
machine name of the OPC server and the data delivery properties for the server 
15 reference includes, for example, information required to coimect to the server such as 
the ProgID or CLSID of the OPC server. 

Support for hierarchical data references is entirely optional and adds to the 
complexity of the data source implementation. 

Data references are preferably organized into collections. Collections occur at 
20 any level in a hierarchical data reference. 

La some embodiments, the data references have predefined sub-objects. An 
example is a server system that supplies all relevant parameters for a given named tag 
(eg AlOO). If a data reference with the ID DataRefl refers to "AlOO" then the Hendrix 
architecture knows its parameters simply as DataRefl .PV, DataRefl. SP etc without the 
25 need for explicit data references for each parameter. 

Data references that are appear as predefined sub-objects are referred to as 
implicit data references. 

As noted above, data references expose the data they refer to as properties. The 
basic property data types supported are VARIANT and OLE DB Rowset. 
30 The following VARIANT types are supported: 

VTJJIl, VTJ2, VTJ4, VT__R4, VT_R8, VT^CY, VT^DATE, VT_BSTR, 
VT^VARIANT, VT_BOOL, VT^NULL, VT_ERROR 

Safe arrays of these types are also supported (VT_ARRAY | *). 
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In other embodiments of the invention a data reference also exposes data to the 
binding engine in the form of an OLE DB rowset. The rowset is exposed as a sub- 

object of the data reference, hi this case the infomiation required to estabhsh the OLE 
DB session and create the rowset is usually part of the data delivery properties of the 
5 data reference. 

Further embodiments have data references that include data delivery properties 
that allow finer control over the reference that than provided by simply changing the 
associated name. An example is a data reference that refers to a single element in an 
array. In such an embodiment, the data reference has an index associated with it in 
10 addition to namespace name. Consider a data reference with the ID ArrayRefl that 
refers to "Analyzerl .ConcentrationData". To fully identify a single element within the 
array an index is also required. The data reference definition for the reference includes 
an initial value for the index and it is subsequently changed using script code as follows. 

ArrayRefl .Index = 2 

15 A further example of a more complex data reference is one that refers to data in 

a relational database that requires a number of SQL query parameters to fully specify 
the reference. 

Data references exist to supply data to the data binding engine. They do this 
through property change notifications. As the data referred to by a data reference 

20 changes in the server system it is dehvered to the data reference using a server system 
specific mechanism. The data reference then notifies the binding engine that a data 
reference property has changed. The notification mechanism allows the data reference 
to pass the changed data to the binding engine as part of the notification which means 
that it is not necessary for the data reference to cache the data intemally. There are, 

25 however, some server systems in which it is advantageous to cache the data within the 
data reference. 

In addition to providing property change notifications a data reference is used, in 
some embodiments, to also fire events. These events are mapped on to methods on 
display page elements or consumed by the binding engine. 
30 Similarly, data references are also used, in some embodiments, to also expose 

methods. These methods are typically commands associated with a particular type of 
data reference. For example, a data reference that provides access to a segment of an 
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array in a server system provides commands (methods) that allow the segment to be 
scrolled along the length of the underlying array. 

Data references are accessible fi*om display page script code via the root of the 
data source object or via display page elements to which they are bound. Accessing the 
5 root of the data reference object model can be done as follows 

Data.data_source_namespace_identifier 

Where Data is the SGML ID of the display page's data source connector and 
data_source_namespace_identifier identifies the data soxirce. A more detailed example 
is as follows: 

10 Data.OPC.ServerRefl.name = "Refinery2" 

Accessing a data reference via a display page element is done as follows: 
Ref = Alphal.DataRefs(index) 

Where index is either the ID of the data reference or the associated name. The 
IDs of bound data references are searched first. If the associated name is associated 
15 with more than one bound data reference, the first is returned. If the display element is 
bound to a hierarchical data reference then the lowest level data reference is returned. 

Each display page has associated with it a series of data source definitions, one 
for each data source from which data is required. Each data source definition contains 
the data source specific information required to construct a data reference object model 
20 that contains the data references required by the display page. 

The data source definitions are stored in an XML document. Each data source 
definition is enclosed in a HENDRIX:DATASOURCE element. This element has 
attributes that identify the namespace with which the data source is associated and the 
CLSID of the data source component. The content of the DATASOURCE element is a 
25 data source specific detail. At a minimum it contains information on how to construct 
data reference objects that reference the required namespace names. 

The format of a data source definition is assumed to be valid XML. If it is not 
valid XML it must be enclosed in a CD ATA section. 

The following example illustrates a data source definition for an OPC data 
30 source (CLSIDs elided for clarity). 

<HENDRIX:DATASOURCE NAMESPACE^^'OPC" CLSID="DA943720- 
8048-1 ld2-8ED5-000000000000" 

CONNECTSTRING-"SERVER=OPCX. . ."> 
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<SERVER NAME="Modbus''> 

<GROIIP UPDATERATE="5000"> 

<!— the following corresponds to a reference to 
"OPC://Modbus.34FC1234.PV" -> 
5 <DATAREF ID="DataRefl" NAME="34FC1234.PV'V> 

</GROUP> 
</SERVER> 
</HENDRIX:DATASOURCE> 



10 The above example illustrates that the organization of the data source definition 

is dependent on the server system that the data source encapsulates. In this case the 
organization is by OPC server and group. 

The following example shows how a data source definition that includes binary 
data might look. 

15 <HENDRIX:DATASOURCE NAMESPACE="LCN" CLSID="DA943721- 

8048-1 ld2-SED5-000000000000"> 

<![CDATA[FE12345AB65C98AFABE192F87E2A26C... 
78C67BAE451F536D]]> 
</HE]SIDRIX:DATASOURCE> 

20 

In this case the organization is not obvious because the definition is an opaque 
blob of binary data. All that matters is that this definition is meaningfiil to the LCN data 
source. 

If a data source supports hierarchical data references, the data somce definition 
25 will need to include the hierarchical relationships between data references. 

As discussed above, data source definitions define the set of data references 
required by a display page. At run time, the entire data source definition is loaded into a 
data source so that the data source is able to construct the required data reference object 
model. 

30 During the display building process data source definitions need to be updated as 

the user adds and removes references to data in the display page. Since the user deals 
primarily with server system namespace names rather than data reference IDs, an 
important design time task is to take a server system namespace name and add a data 
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reference of the correct type to the data source definition. These namespace names 
come from either the Hendrix namespace browser or from direct user input. 

This task is handled by a design time component known as a "data source 
definition editor". A data source definition editor is able to add and remove data 
5 references from a data source definition. They are used by the common display builder. 
They also supply property pages that are used in the common display builder to allow 
the user to configure the data delivery properties for a data reference. 

A data source is an in-process COM object that implements the 
IHendrixDataSource interface. This interface allows the data source manager to 

10 initialise, start and stop the data source. The main purpose of the data source is provide 
a data reference object model to the data binding engine. This data reference object 
model consists of a hierarchy of data reference objects and collections of data reference 
objects. In fact the data reference object model is a standard automation object model, 
with the exception that a more efficient form of connection point mechanism is used. 

15 The data source is initialised with a data source definition that informs the data 

source of what data is required from the server system. Once initialised, the data source 
is transitioned to the running state, in which it dehvers data to the data binding engine 
via the data reference objects. 

The data source also exerts some high level control over the transmission of data 

20 from the data binding engine to the display page. This is achieved via the 

IHendrixBindingEngineCache interface. This is usefiil when a data source wants to 
ensure that an update is delivered immediately to the display page, rather than cached 
for later deUvery as part of a larger update packet. Figure 1 8 shows the relationship 
between the data source manager, data binding engine and data source. 

25 A data reference is a COM object that exposes the IDispatch interface and 

supports property change notifications. OLE DB rowsets are exposed as sub-objects of 
the data reference. This allows the data reference to expose more than one rowset. 
Hierarchical data references and collections of data references are implemented using 
sub-objects in the normal OLE Automation fashion. 

30 A data reference notifies the data binding engine of changes to properties via the 

IHendrixNotify interface provided by the binding engine. Data references that fire 
events do this via IDispatch. 
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OLE DB Rowsets expose IRowset (and related ioterfaces such as lAccessor, 
IConnectionPointContainer etc). An OLE DB rowset notifies the data binding engine of 
changes to the rowset via the IRowsetNotify interface provided by the binding engine. A 
rowset data reference, in some embodiments, also exposes IDispatch if it occurs within a 
5 hierarchical data reference in order to provide access the lower levels of the reference. 

Figure 19 illustrates the relationship between a data reference that exposes a 
property, an event and a rowset to a binding object which is part of the Hendrix data 
binding architecture. 

The previoxis description has gone to the presentation and content aspects of the 
10 Hendrix architecture, that is the HTML/XML display page and the data source 

architecture. The addressee's attention is now directed toward the mechanism that maps 
the content onto the presentation. The data binding architecture is a key element that 
gives the Hendrix architecture much of its flexibility and power. More particularly, the 
data binding architecture provides a means of binding data to virtually anything on the 
15 display page in a very efficient manner. It also provides a very flexible data transfer 
mechanism that accommodates the transformation, combination and filtering of data 
provided by the Hendrix data soirrce architecture. 

MSHTML provides its own data binding mechanism for binding data from 
OLE-DB data sources to HTML elements and ActiveX controls. This mechanism is 
20 deficient in that it expects data in. a tabular form, which is inappropriate for much of the 
data required in an Industrial HMI, and it only binds data to a limited set of properties in 
the DOM. For these reasons, the Hendrix architecture includes its own data binding 
mechanism. 

The MSHTML data binding mechanism does, however, provide good support 
25 for binding to HTML tables. For this reason an interface to the MSHTML data binding 
mechanism for tabular data firom server systems is also available. 

The Hendrix data binding architecture is based on a high performance binding 
engine that maps properties firom the data reference object model on to properties of 
DOM. It does this in an entirely general way so that any property in the data reference 
30 object model is mapped on to any property in the DOM. Figure 20 illustrates the broad 
components in the Hendrix data binding architecture. 

The binding engine uses a series of binding definitions supplied fi-om the 
HTML/XML display file that defines how to map data firom data reference object 
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models to the display page. The binding engine moves data between properties in the 
data reference object model and the display page in response to changes in those 
properties. It can move data in either direction so that data changed in the display is 
propagated back to the data reference object model and then on to the various server 
5 systems. A specialised form of data binding is OLE DB rowset binding where a rowset 
exposed in the data reference object model is mapped on to either a rowset or an OLE 
DB Simple Provider in the display page for binding to HTML tables, 

The binding engine also map events in the data reference object model to 
methods m the display page and vice versa. Blading definitions are discussed in more 
10 detail below. 

The internal architecture of the binding engine is componentised. The transfer 
of data firom the data reference object model to the display page is made through 
tranformations. The simplest form of transformation is one that directly transfers a 
property or event from the data reference object model to the display page. More 

15 complex transformations include a transformation of the data in some way, or use 
several properties firom the data reference object model to derive a value that is then 
transferred to the display page. Transformations are selectively chained together to 
form more complex transformations. Transformations are either supphed by end users, 
consultants to those users, or the provider of the system. 

20 The binding engine executes in an apartment managed by the data source 

manager while the display page executes in its own apartment. Any changes to data in 
the data reference object model are detected by the binding engine which then transfers 
the data to the data source coimector in the display page which applies the updates to the 
display page elements. The binding engine maintains an internal cache of updates that 

25 are transferred to the data soxirce connector in batches to minimize inter-apartment 

round-trips and minimize display page redrawing. This batching of updates only occurs 
for transfers from the data reference object model to the DOM. Transfers in the other 
direction are always immediate. An important consequence of this architecture is that 
the main display page's thread's involvement in the handling of incoming data is 

30 minimized making it more responsive to user interaction. 

Binding definitions are used to tell the binding engme how to map data firom the 
data reference object model on to the display page. Binding defibritions are part of the 
HTML/XML display page. There is one binding definition per display page element 
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that requires data. This organization makes it easier to manage the binding definitions 
in the common display builder. It also makes it easy to access the binding definition via 

the display page element at run time from script code in the display page. 

Each binding definition expUcitly defines the mapping of data from the data 
5 reference object model on to the display page element. The definition takes the form of 
a HENDRIXiBINDINGDEF element. The following example illustrates the broad 
features of a binding definition. 

<!-- the display page element ~> 
10 <SPAN ID="Alphal" CLASS="Hendrix" 

BINDINGEF="AlphalBindingDef'xSPAN> 

<!— the binding definition ~> 

<HENDRIX:BINDINGDEF ID="AlphalBindingDef "> 
15 <BINDING TYPE="Property" SOURCE="OPC.DataR.efl" 

TARGET="PageElement.hmerHTML"/> 
</HENDRIX:BINDINGDEF> 

<!-- the data source definition — > 
20 <HENDRIX:DATASOURCE NAMESPACE="OPC" CLSID="DA943720- 

8048-1 ld2-8ED5-000000000000"> 

<SERVER NAME="Modbus"> 

<GROXJP UPDATERATE="5000'^ 

<!-- the following corresponds to a reference to 
25 "OPC://Modbus.A100.PV" ~> 

<PATAREF NAME="A100.PV" ID="DataRefl"/> 
</GROUP> 
</SERVER> 
<HENDRIX:DATASOURCE> 

30 



Each binding definition consists of one or more bindings that define a property 
to property mapping between properties of data references and properties of tihie page 
element. In this example there is a single binding that maps data from 



wo 01/95041 



PCT/AUOl/00706 



-46- 

OPC.Modbus.A100.PV to the InnerHTML property of the page element with which this 
binding definition is associated, in this case the SPAN element Alphal. 

Note that the type of the binding in this example is "Property". This is the 
default type and is omitted, as required, firom the BINDING element. 
5 The source and target of a bmding are a property of a sub-object of a data 

reference or the page element, as in the following example. However, in other 
embodiments this is not the case. 

<HENDRIX:BINDINGDEF ID="GrouplBindingDef' > 
10 <BINDING SOURCE="OPC.DataRefl .PV" 

TARGET="PageBlement. Alphal . Value"/> 

<BINDING SOURCE="OPC.DataRefl.SP" 
TARGET="PageElement.Alpha2.Value"/> 
</HENDRIX:BINDINGDEF> 

15 

At run time, each binding definition results in the creation of a binding object 
within the data binding engine. 

A binding that binds an event to a method is of type "Event". If the signature of 
an event does not match that of the method to which it is bound a transformation is 
20 necessary to map the event on to the method. 

An important apphcation of event binding is to bind a user interface element that 
generates events to methods (commands) on data references. 

The binding definitions described in above provide for a direct mapping firom 
the data reference object model to the display page. In many cases however, the data 
25 needs to be transformed, combined or filtered in some way before being applied to the 
display page. There are many examples where such transformations are required. One 
example is data driven dynamics such as rotation, translation, path animation and break 
point animation that is to be applied to page elements. In these cases the data to be 
delivered to the display page is derived firom data references and the result is applied to 
30 the display page. Another example is where a value to be delivered to the display page 
is the result of some user written data driven script code as in the case of GUS data 
reference expressions and OnDataChange scripts. A fixrther example is where an event 
is being mapped on to a method with an incompatible signature. 
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To accommodate these sorts of examples the binding engine's data transfer 
mechanism is componentised to allow it to be extended with components to provide 
arbitrarily complex transformations to be perfomied as data and events are transferred 
from the data reference object model to the display page. 
5 The three main types of transformation are property, event and OLE DB Rowset 

transformations. Property transformations transform data. Event transformations map an 
event on to a method facilitating argument conversion and other processing. OLE DB 
Rowset transformations function as OLE DB consumers and map a rowset into either a 
set of discrete properties or another rowset. Mapping to a set of discrete properties is used 

10 to unpack a rowset and apply its contents to a variety of display page properties, while 
mapping to another rowset is used to perfonn queries, sorting, filtering or data reduction 
with the result being another OLE DB rowset (similar to the functions performed by OLE 
DB service providers). 

Transformations are objects with a series of "terminals" which are used as inputs 

15 and outputs to the transformation. The transformations are 'Vired" into the binding 
definitions. 

Transformations also include a programmatic interface that allows it to be 
configured at display building time and manipulated at run time. This interface includes 
methods, properties and events, 
20 The following example illustrates how, in one embodiment, a transfonnation 

that derives an angle of rotation from a data reference is included in a binding definition. 

<!-- the display page element ~> 

<v:rect JD^Tlectl" CLASS="Hendrix" BINDINGDEF="RectlBindmgDef' 
STYLE="..."/> 

25 

<!— the binding definition — > 

<HENDRIX:BINDINGDEF ID-"RectlBindingDef '> 

<XFORM ID="RotationDyn" DEF="CLSID:OEDB0680-81C8-lld2- 
8ED6-000000000000" 
30 PROPERTIES="InitialAngle:0; RotationSpan:270; RangeLow:50; 

RangeHi:150"/> 

<BINDING SOURCE="OPC.DataRefl" 
TARGET="RotationDyn.Value"/> 
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<BINDING SOURCE="RotationDyn.Angle" 
TARGET=''PageElement.style.rotation"/> 
</HENDRIX:BINDINGDEF> 

5 <!— the data source definition ~> 

<HENDRIX:DATASOURCE NAMESPACE="OPC" CLSID="DA943720- 
8048-1 ld2-8ED5-000000000000"> 

<SERVER NAME=''Modbus"> 

<GROUP UPDATERATE="5000''> 
10 <!— the following corresponds to a reference to 

"OPC://Modbus.A100.PV" -> 

<DATAREF NAME="A100.PV" ID='T)ataRefl"/> 
</GROUP> 
</SERVER> 
15 </HENDRIX:DATASOURCE> 

In this example, the binding definition includes the XFORM element which 
declares a transformation known as "RotationDyn" in this blading. The transformation 
is a binary component identified by the CLSID in the DEF attribute. The rotation 
20 transformation has a series of properties used to control the transformation firom value to 
angle. Initial values for these are specified using the PROPERTIES attribute. 

Once declared, the transformation is simply connected mto the data transfer 
mechanism using two separate bindings. The rotation transformation has two terminals 
for this purpose, "Value" and "Angle". The effect of this binding definition is that the 
25 value of the referenced data item is converted to an angle of rotation and delivered to 
the rotation property of the VML rectangle. 

In this example the transformation was a binary component that was written in 
C++. However, in other embodiments use is made of this and/or other programming 
languages such as Visual Basic, Java and the like. This would be appropriate in this 
30 case since the rotation transformation could be very widely used and overall 

performance of the Hendrix architecture would benefit firom a binary implementation. 

Another option is to constmct transformations using an XML syntax and script 
code. Following, there is a description of the use of XML transformations, more detail 
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on constructing binary transformations, and a more complex example that reproduces 
GUS functionality. 

Transformations provide an extremely powerful and flexible way to extend the 
Hendrix data binding architecture. The previous example, a common data 
5 transformation was packaged into a binary transformation component so that it could be 
used to provide rotation dynamics for display page elements. In the following example, 
the data transformation is one that is widely used across many different display page 
elements. This large scale reuse and the performance implications justify the inclusion 
of a binary transformation component. 
10 There are many cases where a "one off" transformation is required for a single 

instance of a display page element. This is the case when a user wants to tailor the 
deUvery of data to the display page using some data driven script code. A common 
example is when a page element requires a data value that is the result of some 
expression involving several data references. XML based transformation components 
15 allow ease of construction of transformations that contain user written script that is 
executed as part of the binding engine's data transfer mechanism. 

The following is a simple example showing an XML transformation that uses 
script code to calculate the sum of two data values. 

<HENDRIX:XFORMDEF ID="AlphalDataScriptDef' > 
20 <rERMINAL ID="Inputl" NOTIFY="Scriptr7> 

^TERMINAL ID='Tnput2'V> 
<TERMINAL ID="Result"/> 
<SCRIPT ID="Scriptl" LANG-"VBScript"> 
Result = Inputl + Liput2 

25 </SCRIPT> 

</HENDRIX:XFORMDEF> 

The XFORMDEF element contains the definition of the transformation. It has 
three terminals; Inputl, Input2 and Result. There is a script element that contains 
30 VBScript code in this example. The script code uses the terminal IDs in the calculation 
of the sum. The temunal Inputl has a NOTIFY attribute that names the script element. 
The effect is that any changes to Inputl will result in Scriptl executing. As will be 
appreciated by those skilled in the art, the terminal input2 does not have the NOTIFY 
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attribute which means that changes in Input! will not result in any script executing. 
Thus, the writer of the XML transformation has complete control over what causes the 
transformation to transfer data. 

The usage of this transformation in a binding definition would be as follows. 
5 <HENDRIX:BINDINGDEF ID="AlphalBindingDef' > 

<XFORM ID="ScriptComp" DEF="AlphalDataScriptDef '/> 
<BrNDING SOURCE="OPC.DataRefl" 
TARGET="ScriptComp.Ihputl ' V> 

<BINDING SOURCE="OPC.DataRe£2" 
10 TARGET="ScriptComp.Input2"/> 

<BINDING SOURCE="ScriptComp.Result" 
TARGET="PageElement.Value"/> 

</EIENDRIX:BINDINGDEF> 

15 hi this case the DEF attribute of the XFORM element indicates that the 

transformation is an XML transformation defined in the current display page. The 
XML transformation, in other embodiments, is defined in a separate file in which case 
the DEF attribute might have Ihe value "URL:AlphalDataScriptDef.xml". 
It is also easy to construct bi-directional transformations using XML 
20 transformations as the following illustrates. 

<EIENDRIX:XFORMDEF ID="SignChangeDef "> 

<rERMINAL II>='Tnput" NOTIFY="Scriptl"/> 
<rERMINAL ID="Output" NOTIFY="Script2"/> 
<SCRIPT ID="Scriptl" LANG="VBScript"> 
25 Output = Input * -1 

</SCRIPT> 

<SCRIPT ID="Script2" LANG="VBScript"> 

Input = Output * -1 
</SCRIPT> 
30 </HENDRDC:XFORMDEF> 

In this example two separate script elements, which perform complementary 
transformations, execute in response to changes in the input and the output. 
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XML transfonnations also include a programmatic interface consisting of 
properties, methods and events. The following example illustrates an XML 
transformation that provides such properties and an event. 
<HENDRIX:XFORMDEF ID="BreakPtDef' > 
5 <PROPERTY ID="CurBreakPt"/> 

<PROPERTY ID="BreakPtl" NOTIFY="Scriptl"/> 
<PROPERTY ID="BreakPt2" NOTIFY="Scriptl'V> 
<PROPERTY ID="BreakPt3" NOTIFY="Scriptl"/> 
<PROPERTY ID="BreakPt4" NOTIFY="Scriptl"/> 
10 <EVENT ID="OnBreakPt"/> 

^TERMINAL ID="Input" NO'nFY="Scriptl"/> 
<SCRIPT ID="Scriptl" LANG="ECMAScript"> 
if(DataVal < BreakPtl &*& !(CurBreakPt = 1) 
{ 

15 CurBreakPt= 1; 

FireEventC'OnBreakPt"); 

} 

else if(DataVal < BreakPt2 && DataVal > BreakPtl && 
!(CurBreakPt = 2) 

20 { 

CurBreakPt = 2; 

FireEventC'OnBreakPt"); 

} 

else if(DataVal < BreakPtS && DataVal > BreakPt2 && 
25 !(CurBreakPt==3) 
{ 

CurBreakPt = 3; 

FireEventC'OnBreakPt"); 

} 

30 if(DataVal < BreakPtl && ! (CurBreakPt = 4) 

{ 

CurBreakPt = 4; 

FireEventC'OnBreakPt"); 



wo 01/95041 



PCT/AUOl/00706 



-52 

} 

</SCRIPT> 
</HENDRIX:XFORMDEF> 



5 This transformation fires the OnBreakPt event whenever the input value enters a 

new break point region. The break point regions as defined by the four properties 
BreakPtl, BreakPt2, BreakPtS and BreakPt4 control the configuration of the 
transformation and the property CurBreakPoint reflects the current state of the 
transformation. 

10 A transformation appears at run time as a subobject of the page element that it is 

associated with. This allows script code in the display page to access the 
transformation's properties and methods and receive any events it generates. This is 
illustrated in the following example which makes use of the above transformation. 
<SPAN ID=*'Alphal" CLASS=''Hendrix" 
15 BINDINGDEF="AlphalBindingDefV> 
</SPAN> 

<HENDRIX:BINDINGDEF ID-"AlphalBindingDef' > 
<XFORM ID="BreakPt" DEF="BreakPtDef' 
PROPERTIES="BreakPtl:40; BreakPt2:80; BreakPt3:120; BreakPt4:160'V> 
20 <BINDING SOURCE="LCN.DataRefl" TARGET=''BreakPt.Input"/> 

</HEKDRIX:BINDINGDEF> 

<SCRIPT FOR="Alphal.BreakPt" EVENT="OnBreakPt" 
LANGUAGE="ECMAScript"> 
25 switch(Alphal .BreakPt.CurBreakPt) 

{ 

case 1: SoundPlayer.Play("normal.wav"); 

break; 

case 2: SoundPlayer.Play("alert.wav"); 

30 break; 

case 3: SoundPlayer.Play("highalert.wav"); 

break; 

case 4: SoundPlayer.Play("codered.wav"); 
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break; 

} 

</SCRIPT> 



5 Note that, in this example, there is no data actually traasferred by the binding 

engine to the display page. Instead, the information is retrieved jfrom the traasformation 
by a display page script when the transformation generates an event. Note also that the 
transformation is actually out-of-apaitaient with respect to the page element with which 
it is associated. This means that accessing the transformation incurs the usual 
10 performance penalty for such cross apartment calls. 

It is also important to note in this example that the script code in the XML 
transformation is executed in the binding engine on a thread managed by the data source 
manager, while the script code responding to the event fired by the transformation 
executes in the display page on the main UI thread. 
15 XML transformations are also used to map an event on to a method when there 

is a mismatch between their signatures which means that the binding engine camiot bind 
them directly. The following example shows how an XML transformation is used to 
map an event with one argument on to a method with two arguments. The 
transformation supplies the value of the second argument itself. 
20 <HENDRIX:XFOIUV[DEF ID="AlphalEventXFor^ 

<TERMINAL ID="Input" NOTIFY="Scriptl"/> 
<TERM]NAL ID="Outpuf V> 
<SCRIPT ID="Scriptl" LANG="VBScript"> 
Method(Input.args(l), 10); 

25 </SCRIPT> 

</HENDRIX:XFORMDEF> 



<HENDRIX:BINDINGDEF ID="AlphalBindingDef' > 

<XFORM ID="EventXForm" DEF-"AlphalEventXFonnDef' /> 
30 <BINDING TYPE="Event" SOURCE="TPA.DataRefl .Recalculate" 

TARGET="EventXForm.Input"/> 

<BINDING TYPE="Event" SOURCE="EventXForm.Output" 
TARGET="PageElement.Rescale"/> 
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</HENDRIX:BINDINGDEF> 



Note that the bindings in this case are of the type "Event". The default binding 
type is "Property". 

5 Note also the use of the args collection of the "Input" terminal. This collection 

is always available even on terminals used for properties in which case args(l) contains 
the property value. 

XML transformations are also used to alter the semantics of the default 
transformation that is implied by a binding deJSnition that binds data directly from the 
10 data reference object model to the display page without the explicit use of 

transformations. This default transformation has an equivalent XML defijoition as 
follows. 

<HENDRIX:XFORMDEF ID='T)irectBindingDef' > 

<TERMINAL ID="Input" NOTIFY-"Connectionl"/> 
15 <TERMINAL ID="Output" NOTIFY="Comiection2"/> 

<CONNECT rD="Connectionl" FROM="Input" TO="Output"/> 
<CONNECT ID="Comiection2" FROM-"Output" TO="Input"/> 
</EIENDRIX:XFORMDEF> 



20 The CONNECT elements form a direct connection from one terminal to another. 

In this case, the default case, the connections are notified of any changes to their source 
terminals creating the effect of a bi-directional connection. The semantics are changed 
by changing the NOTIFY attributes, adding extra connections etc. For example, a 
transformation that broadcasts a value to several page elements follows. 
25 <HENDRIX:XFORMDEF ID='T)irectBindingDef'> 

<TERMINAL ID="Input"NOTIFY="Connectionl; Connection2; 
Connection3"/> 

<TERMINAL ID="Outputl"/> 
<TERMINAL ID="Output2"/> 
30 <TERMINAL ID="Output3"/> 

<CONNECT ID="Connectionl" FROM="Input" TO="Outputl"/> 
<CONNECT ID="Connection2" FROM="Input" TO="Output2'V> 
<CONNECT ID-"Connection3" FROM="Input" TO-"Output3"/> 
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</HE]SIDRIX:XFORMDEF> 



in this case changes in the input are propagated to the outputs but changes in the 
outputs are not propagated back to the input. This is different to the effect that would be 
5 obtained if the following binding definition without explicit binding connections were 
used. 

<HENDRIX:BINDINGDEF rD="GrouplBindingDef' > 
<BINDING SOURCE="OPC.DataRefl" 
TARGET='TageEleme!nt.Alphal.Value"> 
10 <BI]SrDING SOURCE="OPC.DataRefl" 

TARGET="PageElement.Alpha2.Value"/> 

<BINDING SOURCE="OPC.DataRefl" 
TARGET='TageElement.Alpha3.Value"/> 
<ENDRIX:BINDINGDEF> 

15 

The following example illustrates how transformations are used to reproduce 
GUS ftmctionaUty. The scenario considered is that of a text object with an 
OnDataChange script that references one data value and a rotation dynamic driven by a 
data reference ejqpression that is the sum of two other data values. 
20 Firstly, an XML transformation is defined to capture the OnDataChange script 

and the data reference expression used to drive the rotation dynamics. 
<HENDRIX:XFORMDEF ID="AlphalScriptDef' 

<rERMINAL JD=^Tnp\xtr NOTIFY="OnDataChangeScript"/> 
<a'ERMINAL ID="Outputl"/> 
25 <TERMINAL ID="Input2" NOTIFY="DataReferenceExpf' /> 

<TERMINAL ID="hiput3" NOTIFY='T)ataReferenceExpr"/> 
<rERMINAL ID="Output2"/> 
<SCRIPT ID="OnDataChangeScript" LANG="VBScript"> 

Outputl = Func(Inputl) 

30 <ySCRIPT> 

<SCRIPT ID="DataReferenceExpr" LANG="VBScript"> 

Output2 = Input2 + Inputs 

</SCRIPT> 
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</EffiNDRIX:XFORMDEF> 

Inputl is the input to the OnDataChange script and Outputl is the result. Input2 
and Inputs are inputs to the data reference expression and Output2 is the result of the data 
5 reference expression. This XML transformation and the binary rotation transformation 
discussed earlier are now used in a binding definition for a display page element. 

<OBJECT ID="Alphal" CLASS="Hendrix" CLSID=". . ." 
BINDINGDEF="AlphalBindingDef'> 
</OBJECT> 

10 

<HENDRIX:BINDINGDEF ID="AlphalBindiiigDef'> 

<XFORM ID="AlphalSciipf ' DEF="AlphalScriptDef' /> 
<XFORM ID="RotationDyn" DEF="CLSID:0EDB0680-81C8-lld2- 
8ED6-000000000000" 
15 PROPERTIES="IiiitialAngle:0; RotationSpan:270; RangeLow:50; 

RangeHi:150"/> 

<BINDING FROM="LCN.DataRefl" TO="AlphalScript.Inputl"/> 
<BINDING FROM="AlphalScript.Outputl" 
20 TO="PageElement.Value"/> 

<BINDING FROM="LCN.DataRef2" TO="AlphalScript.Input2"/> 
<BINDING FRO]V[='XCN.DataRef3" TO="AlphalScript.Input3"/> 
^BINDING FROM=="AlphalScript.Output2" 
TO="RotationDyn.Ii^ut"/> 
25 <BINDINGFROM="RotationDyn.Angle" 
TO="PageElement.Rotation"/> 

</HE]SIDRIX:BINDINGDEF> 

As will be appreciated by a skilled addressee, given the teaching herein, a data 
30 source definition that defined DataRefl , DataRef2 and DataRefB as referring to 

LCN://A100.PV, LCN://A200.PV and LCN://A300.PV respectively is also required. 

Iq this example, two transformations are chained togeflier to build iq? the 
required combination of data transformations to achieve the desired result. 
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From the preceding description, it is clear that explicit transformations are used 
when data needs to be transformed as it is transferred to the display page. The 
transformation is, in some cases, one that adds real value to the data as it is transferred — 
as in the case of a rotation dynamic - or it is, in other cases - simply to massage the data 
5 sUghtly into a form that the controls on the display page expect. This latter category of 
transformations is largely eliminated for the controls of the system provider or designer as 
a close correspondence between the form of the data as delivered by data source 
components and the form expected by the controls on the display page is designed into the 
system. This is also possible for controls targeting a specific server system. To achieve 

10 this for controls that are reusable across provider server systems requires convergence on 
the details of the object models supplied by the various data source components. 

The present embodiments also support another desired feature of an industrial 
HMI, that being the ability to issue coimnands to the server system. These commands 
are often issued from page elements themselves as in the case of selecting a page 

15 element and pressing a function key to call up a point detail or right clicking a page 
element to pop up a context menu from which an action can be selected. Commands 
are, in some embodiments, also issued from the user interface framework as in the case 
of the operator entering a command into the command zone or selecting a menu item 
from the framework's menu. 

20 Part of the power and flexibility of the architecture used in the embodiments of 

the invention comes from the separation of content from presentation. This is achieved 
through the use of distinct data source and data transformations that free the page 
elements from most of the work involved in the provision of data to the display page. 
This has the added and une^qpected benefit that data is available to be provided to any 

25 page element, not just those supplied by the system designer or provider. A similar 
approach is taken with commands that are issued to the server system. These are 
abstracted out of page elements into distinct components that allow the commands to be 
issued from any page element, not just those supplied by Honeywell or another system 
provider. 

30 The command architecture of the preferred embodiments also allows command 

behaviour to be associated with any page element and for commands from page 
elements and the user interface framework to be routed to the server system. 
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Commands are implemented as methods on objects in the data source object 
model. Commands are, in some cases, system wide — such as commands to change 
operator security level — or server specific — such as acknowledging alarms or calling up a 
point detail. These different classes of commands are implemented at the level of the data 
5 source obj ect model. 

System wide commands are implemented on the root of the data source obj ect 
model. Server specific commands are implemented on the root node of each data 
source component object model. The commands are usually accessed via script code or 
via command behaviours associated with display page elements. 
10 The Hendrix architecture allows command behaviour to be associated wilii any 

page element on a display page. This means, foj example, that a user is able to select a 
third party control on a page and ri^t chck on it to pop up a server specific context 
menu or press a fixnction key to perform a server specific action such as point detail. 

In the Hendrix architecture this ability to associate server command behaviour 
15 with any page element leverages the DHTML behaviour mechanism provided by 
MSHTML. A DHTML behaviour is a component that encapsulates behaviour that 
would normally be coded into a page element or added to it via script code. A 
behaviour component "wraps" any page elements it is applied to, extending its object 
model and run time behaviour. This mechanism provides the means by which server 
20 specific command behaviour is extracted out of page elements in a form that is able to 
be associated with any page element. 

In practice, server command behaviours fall into several distinct categories. In 
these cases, several individual behaviours are implemented as part of the one behaviour 
component. 

25 The command behaviour component implements the standard behaviour 

interfaces such as lElementBehavior and lElementBehaviorFactory. Command 
behaviours respond to user events such as keystrokes and mouse clicks, and initiate the 
appropriate server commands when these events occur. It issues the commands via the 
command methods in the data soiurce object model. 

30 Associating a command behaviour with a page element is as simple as applying 

the behaviour to the element via the standard CSS mechanisms. The following example 
shows how a command behaviour is associated with a third party gauge control. 
<!— a third party gauge control — > 
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<object id="alphal" CLASS='TlansctapeConmiaads" 
classid="clsid:36D15A51-1558-l ld2-8dfA-00C04FF010A0" styl^^^ 
top:500; left 500; height: 50; width: 100"> 

<param nanie="rLeedleStyle" value="4"> 
5 <param natne="rangeLow" value="0"> 

<param name- 'rangehigh" value="100"> 
</object> 

In other embodiments altemative associations are utilised. 
10 In the case of a user interface framework, commands are usually issued directly 

to the data source object model, although this is dependent on the user interface element 
issuing the command and the implementation strategy used in constructing the 
framework. 

The ability to reuse display pages as building blocks for other display pages is an 
15 important factor in minimizing the engineering cost of developing display pages for 
Honeywell and other provider server systems. This holds is both for standard displays 
that are shipped with a system and for displays built for a customer site by consultants 
or the customers themselves. 

The Hendrix architecture provides three mechanisms for acliieving display page 
20 reuse. Tliese are encapsulation, interface extension and data reference parameterisation. 
Encapsulation refers to preparing a Hendrix display page for later reuse by storing it in a 
separate file so that it is available for being embedded or linked into a containing 
display. Interface extension refers to adding properties, methods and events to the 
display page so that it is available to be treated as a ftilly fledged component in a 
25 containing display page. This greatly increases the utility of reusable display pages. 
Data reference parameterisation refers to defining data references using tokens that are 
substituted in the containing display when the display is linked or embedded. 

Note that the previous description relies upon the file format aspects of display 
page reuse. Display page reuse is also an important source of requirements for the 
30 Honeywell common display builder. 

A Hendrix encapsulation is formed when display page elements are contained 
within a HENDRIX:ENCAPSULATION element and is stored in a separate file. The 
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following example the encapsulation of a span tag that displays LCN.AIOO.PV and is 
stored in the file SimpleFaceplate.htm 

<HEKDRIX:ENCAPSULATION> 
<CONTENT> 

5 <SPAN ID^"PVSpan" CLASS="Hendrix" 

BINDINGDEF="PVSpanBindingDefV><SPAN> 

<HENDRIX:BINDINGDEF ID="PVSpanBindingDef V> 
<DATA ID="DataRefl" REF=''LCN.A100.PV"/> 
<BINDING FROM='T)ataRefl" 
10 TO='TageElement.IhnerHTML"/> 

</HENDRIX:BINDINGDEF> 
<VCONTENT> 
</EIENDRIX:ENCAPSULATION> 



15 The encapsulated display page elements are contained in the CONTENT 

element. 

An embedded instance of the encapsulation follows: 
<DIV ID="Faceplatel" CLASS="HendrixEncapsulation" 
DEF="SimpleFaceplate,htm''> 
20 <!-- content of faceplate appears inline here — > 

</DIV> 



The embedded encapsulation appears as a DIV in the containing display page 
with the HendrixEncapsulation behaviour applied to it. 
25 Interface extension is achieved in the Hendrix architecture using the DHTML 

behaviour mechanism provided by MSHTML. This mechanism was briefly discussed 
earlier with reference to command behaviours, DHTML behaviours provide a general 
mechanism for extending the object model of any display page element with properties, 
methods and events. 

30 Properties, methods and events are added to an encapsulated display by adding 

an INTERFACE element to the encapsulation. The following example provides an 
illustration. 

<HENDRIX:ENCAPSULATION> 
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<INTERFACE> 

<PROPERTY ID="Propl"> 
<METHOD ID="Methodl"/> 
<EVENT ID="Eventl"/> 
5 <SCRIPT LANGUAGE="VBScript"> 

sub Methodl(x) 

if #Encapsulation.Propl = 0 aad x > 0 then 

#Encapsulation.FireEveat("Even.tl "); 

end sub 

10 <ySCR]PT> 
<;/INTERFACE> 
<CONTENT> 

<OBJECT ID="PVSpan" CLASS^'Hendrix" 
BINDINGDEF="PVSpaiiBmdingDefV><SPAN> 
15 <HENDRIX:BINDINGDEF ID="PVSpaaBindmgDef' /> 

<DATA ID="DataRen" REF="LCN.A100.PV"/> 
<BE>JDING FROM="DataRefl" 
TO="PageElementImierHTML"/> 

<yHENDRIX:BINDINGDEF> 
20 <CONTENT> 

</HENDRIX:ENCAPSULATIO]S> 

Note the use of the fflEncapsulation symbol to refer to the properties and methods 
of the current encapsulation. 
25 An embedded instance of the eac^sulation could look like: 

<DIV ID="Faceplatel" CLASS="HendrixEncapsulation" 
DEF="SimpleFaceplate.htm"Propl="l"> 

<!— content of faceplate appears inline here ~> 
</DIV> 



Note that Propl is given an initial value inline in the DIV element's start tag. 
The properties, methods and events are now available on the embedded instance 
for use in saipt code in the containing display page as follows. 
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FaceplateLPropl = 2 
Faceiplate Methodl (3) 



<SCRIPT FOR="Faceplatel" EVENT="Eventl" LANGUAGE="VBScript"> 
5 'event handler code here 

</SCRIPT> 



An encapsulation, as used in some embodiments, includes data reference tokens 
that are used to parameterise data references that appear in the encapsulated display 
10 page. The following illustration shows one method of parameterising the data reference 
in the previous examples. 

<HENDR[X:ENCAPSULATION> 
<INERFACE> 

<rOKEN ID="PointID> 
15 </INTERFACE> 
<CONTENT> 

<SPAN ID="PVSpan" CLASS="Hendrix" 
BINDINGDEF="PVSpanBindingDef'/><SPAN> 

<HENDRIX:BINDINGDEF ID="PVSpanBindingDef' /> 
20 <DATAID="DataRefl"REF="##PointID.PV"/> 

<BINDING FROM="DataRefl" 
TO="PageElement.ImierHTML"/> 

<HENDRIX:BINDESrGDEF> 
<CONTENT> 
25 <HENDRIX:ENCAPSXJLATION> 



The data reference now includes the symbol ##PointID, which is an instance of 
the token PointlD. PointID is declared as a data reference token using a TOKEN 
element in the INTERFACE part of the encapsulation. When the encapsulated display 
30 page is embedded or linked into another display page the data reference tokens are 
given values which are then substituted into the tokenised data references within the 
encapsulated display page. 
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The following example illustrates how the encapsulation is used in a containing 
display page. 

<DIV ID^'Taceplatel" CLASS="HendrixEncapsulation" 
DEF="SimpleFaceplate.htm" 

PointID="LCN.A100"> 
<!— rest of faceplate appears inline here --> 
</DIV> 



In this case the token PointID is given the value LCN.A100. 
10 When deterniining what data references exist in the embedded (or linked) 

encapsulation, the Honeywell common builder performs a token pasting operation to 
complete any parameterlsed data references. 

The data reference tokens are accessible at run time as part of the embedded (or 
linked) encapsulation's object model. For example, the following line of would cause 
15 the bindings that depend on the token to be unbound and then rebound to new objects in 
the data source object model. 

Faceplatel.Tokens("PointID") = "LCN.A200" 

This assumes that the data source object model already contains the data for 
LCN.A200. The containing display page will look after this detail using tlie technique 
20 suggested earlier with reference to data binding definitions. 

If token values are omitted from an embedded encapsulation at the time it is 
embedded, the data references and binding definitions that depend on them are ignored. 
Token values are then supplied at run time causing the binding definitions to take effect 
at that time. 

25 As discussed so far in this description, the Hendrix architecture typically 

consists of a client machine on which display pages are viewed and one or more server 
systems firom which data is delivered to the client. The data is delivered to the client 
machine by the server system specific data source components and presented to the data 
source manager in the form of hierarchical object models. The data soiirce manager 

30 consoUdates the various data source component object models into a single data source 
object model. The binding engine, which is also managed by the data source manager, 
then transfers the data from the object model to the display page as changes occur. This 
arrangement is shown in Figure 21 . 
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The client portion described above is also, in the preferred embodiments, run on 
a server system. This is usually necessary in cases where a data source component does 
not include a remoting mechanism for delivering data to a separate client machine. 
Figure 22 illustrates this arrangement. 
5 These two topologies both feature a thin client and are suitable in some control 

room scenarios where conventional workstations are the norm and network connections 
are regarded as potential points of failure. 

There are, however, other topologies for the Hendrix architecture that are used in 
other embodiments. As discussed in previously, the data binding engine executes in an 

10 apartment managed by the data source manager. The motivation for this is to ofQoad 
the work associated with delivering data and transforming to a thread other than the 
main user interface thread. Commxuiication between the binding engine and the display 
page is an efficient batch transfer mechanism that minimizes inter-apartment round 
trips. This split between the servers systems and the data source manager (different 

15 machines) and the data source manager and the display page (different apartments) 
makes Hendrix a three-tier architecture. The data source manager and the components 
it manages form the middle tier. If the interface between the data source manager and 
display page is made remotable, as is the case in some embodiments, then a number of 
other network topologies are possible. 

20 These topologies feature a very thin client and would be suitable for veiy thin 

client platforms such as hand held and wearable computers. One locates the middle tier 
on one of the server systems while the other locates it on a distinct machine. These are 
illustrated in Figure 23and Figure 24. 

The thin client topologies allow the data source manager to be shared across 

25 display pages on the same machine while the very thin client topologies allow the data 
source manager to be shared across displays on different machines. This allow the data 
source manager to act as a common "display database". 

Another advantage of the very thin client approach is that only the data actually 
needed on the page is sent to the client rather than all of the data required to derive the 

30 needed data, thus minimizing the volume the data communications to the client. This is 
important for clients operating over low bandwidth communications links. 

Having the middle tier on a distinct machine is also important where 
computationally expensive transformations are performed in transformations as occurs 



wo 01/95041 



PCT/AUOl/00706 



-65- 

where historical data from server systems is being prepared for a complex 3D data 
visualization. This functionality enables very thin clients to present the visualization 
and also avoid loading the server systems with the computational burden. 

In' some embodiments the middle tier represents the ideal place for a web server 
5 used to deUver display pages to the clients. One implication of this is that it is better for 
the data source definitions and binding definitions to be stored separately from the 
display page and passed directly to the data source manager as the display page is 
delivered rather than having them passed to the client as part of the display page only 
for them to be sent back to the middle tier. 

10 There are different classes of user of an industrial HMI ranging from those who 

require casual access to display pages via a web browser to those who spend all day 
working with display pages at a dedicated console in a control room. These different 
users have different requirements for the environment in which they use display pages. 
These differing requirements are reflected in differing display page frameworks. A 

15 display page framework is generally some surrounding user interface infrastructure that 
helps the user to navigate and interact with display pages. This infrastructure includes 
menus, toolbars, status zones, alarm zones, message zones, command zones, change 
zones, and the like. Another important class of framework functionality is the window 
management provided by software such as the commercially available Honeywell 

20 Safe View product. 

The Hendrix architecture, in conjunction with SafeView, provides a rich tool kit 
for constructing display page frameworks. Some teclmiques for constructing 
frameworks using the Hendrix architecture are described below. 

The simplest form of framework is no visible framework at all. This occurs 

25 when, for example, SafeView alone is used to manage the user interface of an operator 
console. This is achieved by using the Hypertext Application (HTA) mechanism 
available in MSHTML. This allows a display page to appear standalone without any 
visible framework, much in the same way that present day GUS displays appear. 
The common model for casual access to information is the web browser. 

30 Internet Explorer provides a state of the art web browsing interface that is ideal for 

casual access to display pages. Display pages are called up by entering a direct URL in 
the browser or by any of the other myriad navigation tools available in this environment. 
Examples include favourites or bookmarks, navigation history and hyperlinks from 
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other display pages or from other HTML pages that are part of the general corporate 
intranet. 

In the case of a web browser, the framework in which pages are viewed is the 
regular web browser user interface. It does not include any user interface elements that 
5 are HMI specific. In general tliis is not a limitation. In some cases however, there is a 
need for some extra user interface elements in the display page itself to allow the user to 
interact with the process or server system in a way that would normally be provided by 
an HMI specific framework. An example of this is a minimal user interface to allow the 
user to enter commands into a command zone. This minimal user interface is, in some 
10 cases, delivered as a control on the display page whose visibility would be determined 
by the framework in which the display page is viewed. 

Industrial process control systems, such as those provided by Honeywell, are 
used in many industrial domains. The operational environments that exist in these 
domains vary greatly depending on the nature of the processes being managed. Even 
15 within a particular domain, operational requirements will vary witli different operational 
policies in place at different organizations. 

As discussed above, a framework is some user interface infrastructure in which 
display pages can be viewed, navigated and mteracted with. A framework typically 
contains user interface elements such as menus, toolbars, status zones etc. The Hendrix 
20 display page architecture itself provides a perfect mechanism for constructing these 
frameworks. This is especially tme as the Hendrix data binding architecture makes it 
easy to populate the framework with data from the server system and process. 

Third party tools are rapidly emerging with which rich HTML based user 
interfaces can be constmcted. Examples of these include menus and toolbars 
25 implemented as binary behaviours for use with MSHTML. 

Display page scripting is provided by MSHTML. It supports script code vmtten 
hi any language for which an ActiveX scripting engine implementation is available. 
The most popular scripting languages on web pages are JavaScript, now known as 
ECMAScript and VBScript. Microsoft provides ActiveX scripting engine 
30 implementations for both languages. 

The one aspect of display page scripting that is provided by the Hendrix 
architecture is named data access. 
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An important aspect of providing data to a display page is that of making the 
data available to script code in the display page. In the Hendrix architecture this means 
making the data source object model accessible to the display page scripting 
environment. This is done via the data source connector which provides an object 
5 model that mirrors the data source object model. This object model actually provides a 
local, standard OLE Automation version of the data source object model. As an 
optimisation, the data source connector object model is created on an as needed basis, as 
it is accessed, by executing script code. 

Script code on the page accesses data in the data source object model simply by 
10 referring to it via the data source coimector which, for convenience, is called *T)ata" in 
liie display page. 

Data.OPC.A100.SP = 100 

This example assumes that the data item OPC.A100.SP actually exists in the 
data source object model. The earlier description on the data binding architecture 

15 describes how to make sure the data source object model contains all of the data that 
display page script code might require. 

Robustness and stability are essential features of an Industrial HMI. The 
Hendrix architecture is designed in such a way as to minimize the impact of failures in 
HMI components. The main areas of risk are ActiveX controls in the display page, user 

20 written script code in the display page, binary transfomiations and XML 

transformations. These are all areas where it is possible for "foreign*' components to be 
introduced into the HMI. These foreign components provide a risk of catastrophic 
failure or, in less acute cases, simply take too long to execute. 

The failure of any one of these components will have a direct impact on the 

25 particular display page which those components are a part of or are servicing. The 
Hendrix architecture is designed such that the impact of any of these failures will be 
limited to that particular display page. This extends to any user interface framework 
that is managing a display page. This ensures that even if a display page fails 
catastrophically, the framework will remain intact so the user is able to continue to 

30 receive process and system information through the framework and/or navigate 
immediately to another display page. 
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In some embodiments, special components are developed to achieve the desired 
robustness. For example, specific robust display page containers that execute a display 
page in a separate process on behalf of a user interface framework. 

The script code execution environments (MSHTML and the XML 
5 transformations) monitor the execution of script code so that code that takes too long to 
execute is identified and remedial action taken. 

Inter-display communication consists of two aspects: 
1 . Communication at display invocation time, consisting of the ability of one display 
being able to pass parameters to another when it is invoked, and 
10 2. Connucnunication after a display is loaded, consisting of the abiUty to share persistent 
data between displays, and across display invocations. 

A display may be invoked in one of two ways: either in the same window as the 
calling display (such as a normal hyperhnk in the browser) or in a new window. When 
it comes to passing invocation parameters to such a display, these two scenarios are 
15 slightly different. 

When changing to a new display in the same window, display parameters are 
used to transmit some kind of state information (such as the currently selected point, or 
previously entered user data) to the new display. In the Hendrix environment, there are 
a number of methods available for this purpose, the first three of which utihse web 
20 technologies: 

1 . Storing the information in a cookie as part of the document object model. 

2. Storing the information as structured XML data (available in EES). 

3. Storing the information on the server, by using Active Server Pages and placing the 
parameters in the hyperlink definition (e.g. 

25 http://server/new_display.htm?paraml=20&param2=30). 

4. Using the global data repository provided by the global data repository (see below). 

As far as Hendrix is concerned, any of these methods are appropriate to pass 
parameters to a new display. The Hendrix architecture is designed to permit the use of 
pertinent technologies, but not mandate it. The architecture does not require the use of 
30 Active Server Page technology, for example, but hkewise it does not prohibit its use 
where appropriate. Note that adopting a custom form of hyperlink (where parameters 
are passed locally on the client, for example) would not be appropriate, as the parameter 
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passing mechanism needs to function in both the web browser and the operator 
environments. 

This is not the case when displays are invoked in a separate window, however. 
In HTML, a new window is opened by a normal hyperlink, or by script, as for a single 
5 window. The difference Ues in the fact that the system must determine what frame 
window to use for the new window. Consider the following scenarios: 



Invoking Display 


Invoked 
Display 


Expected Behavior 


Display in operator 
environment 


New display 


Invoked display should be called up in 
the operator environment. If custom 
frame windows are used for the 
operator environment, the new display 
should be called up within such a frame 
window. 


Display in browser 


New display 


hivoked display should be called up in a 
browser window. 


Display in operator 

environment 


Popup 

faceplate 


Popup window should be called up in 

custom faceplate frame window. 


Display in browser 


Popup 
faceplate 


Popup window should be called up in 
either custom faceplate frame window, 
or browser window without 
toolbar/menu. A ftiU browser window is 
not appropriate for popup faceplates. 



These scenarios illustrate that the behaviour of invoked windows is not fixed, 
and instead depends on the environment in which they are viewed and the type of 
10 display being invoked. Other scenarios are also possible. (Note that popup faceplates 
have ttieir own specialized requirements, and are described fttrther elsewhere in this 
description). 

While the normal hyperlinking mechanism allows the new document be opened 
in a second window, it does not provide any mechanism for passing arbitrary parameters 
15 to this new document. Even more importantly, it is unable to dynamically determine if 
the new window should be created in a browser window or in a frame suited to the 



wo 01/95041 



PCT/AUOl/00706 



-70- 

operator enviroimient. To create external windows, and to pass parameters to them, 
script must be used. 

There are a number of possible methods for passing parameters to a new display 
at invocation time. These include the use of client-side mechanisms such as cookies, 
5 structured XML data stores, the global data repository (described below), and even the 
use of HTML behaviours to allow a display to expose properties, methods and events. 
None of these methods, however, ensure that the parameters being passed are initialised 
before the new display begins executing. This result in displays showing invalid data 
upon invocation, and also, in more extreme cases, result in script errors. While any of 
10 these mechanisms are usable in the Hendrix architecture, the standard way to invoke 
displays and pass parameters to them is provided by the data source connector. 

The data soxirce connector provides a method call for the creation of new 
displays, as follows: 

wlndow2 = Data.createWindow(URL [, parameter_string ]) 
15 Where parameter_string is a single string that is capable of specifying an 

arbitrary nimiber of named parameters. Its format is modelled on the format used for 
specifying CSS attributes in HTML, and is a semi-colon delimited list of name/value 
pairs. Each name/value pair is of the form name : value. For example: 

createWindow("display2.htm" , "paraml:LCN.A100.PV; 
20 servemame:chevron5"); 

createWindow("display3.htm" , "param2:* embedded string as 

parameter'"); 

The data source connector invokes the new display^and passes parameters to it 
according to the following sequence: 
25 1 . The data source connector invokes a new display with the given tIRL 

via the method appropriate to the current environment (browser or operator). The data 
source connector is aware of whether it has been loaded in the browser or an operator 
frame, and is thus able to decide how it should create the new wmdow. 

2, The data source connector on the new display obtains a pointer to the 
30 invoking data source connector (via the opener property of the window object in the 

DOM.) 

3 . The data source connector on the new display retrieves the parameter 
list. It does this by utilizing the IHendrixDisplayParameters interface exposed by the 
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invoking data source connector. The IHendrixDisplayParameters interface is detailed 
below. 

4. If no parameters are to be passed (the parameter Ust is empty), or no 
invoking display exists (the opener property is null), the new data source connector fires 

5 the OiiPageLoadComplete event into the DOM. Display pages must be written such 
that no data processing can commence prior to this event being fired. 

5. If display parameters are to be passed, the new data source connector 
retrieves the parameter string, exposes the passed parameters via its own object model 
as explained below, and fires the OnPageLoadComplete event. The page is then ready 

10 to commence normal processing. 

The data source connector exposes parameters it has retrieved as part of its own 
object model, iti the displayParameters collection. A collection is used, rather than 
extending the object model of higher-level objects in the DOM, to avoid the possibility of 
namespace collisions. Parameters are accessed by name or by index (according to the 
15 order they were placed in the original parameter string). So, for the first example above: 
vail = Data.displayParameters(0) ' vail = "LCN. Al OO.PV" 
val2 = Data.displayParameters("servemame") * val2 = *'chevron5" 

The Hendrix global data repository is, as its name implies, a global repository of 
20 data which facilitates inter-display communication. It is a component of the data source 
manager, and fimctions as a data source component, supplying the binding engine with an 
object model that is able to be bound to elements on a display page. The data repository is 
thus 'global' in the sense that all displays served by the data source manager are able to 
access its data. For a single-node system (refer to Figure 22) this implies that the data is 
25 machine-wide. In the case of a distinct middle tier, however (refer to Figure 23), this 
implies the ability to share display data across nodes. The global data repository 
replicates the functionality of the Display Database found in GUS systems. 

The Hendrix global data repository has a number of requirements, in that it: 

1 . Allows the user, through script, to store values in a global repository, 

30 from where those values are retrievable by other displays running on the machine. This 
global data must remain available even after the display is terminated. 

2. Allows the user to store values in a local repository. Data in the local 
database has a Ufetime dictated by the lifetime of the display itself- when the display is 
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unloaded or changed, the local data is lost. The original reasons for a local repository 
were for migration from LCN to GUS. In many ways a local database is no different 
from user-defined variables in script on a page, and for those embodiments where 
migration issues are solved, then it would not be required. 
5 3. Allows the user to bind to data values stored in the data repository. This 

means that one display (or even an extemal appUcation) is able to drive the data shown 
on a second display simply by changing values in the data repository. 

4. Allows the user to store references to data as variables in the database. 
These variables are updated Uve to reflect real process values in a target system. 
10 5. Allows objects on a page to bind to data references in the global data 

repository. In GUS terminology, this means the abiUty to reference objects in the global 
data repository in the body of an OnDataChange script. In the Hendrix architecture, this 
translates to the ability of the binding engine to map data from the global data repository 
on to the page. 

15 The above describes how the first three of these requirements (related to storing 

simple variables) are implemented in the Hendrix architecture. The ability to store 
references in the repository is discussed elsewhere. 

Access to the global data repository is provided by the data source connector on 
each page. This object provides script on the page access to the data repository 
20 fimctionality via the DOM. The global data repository is based around a name-based 
collection of user-definable variables, rather than a fixed set of attributes. The user is 
able to define their own database variable names, allowing for greater flexibility. 

The data source coimector has three methods related to the storage of simple 
variables (Add, Item, Remove) and one property (count). These fimction as follows: 
25 Data.Add: 

Adds a new item, in the form of a named variable, to the global data repository. 
The syntax for this operation is: 
Data.Add(name, value) 

where name is a string, and value is a variant. For example: 
30 Data.Add("valOr', 97.2) 

Data.Add("val02", "string__value") 



DataJtem 
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Retimis the specified item from the global data repository. The syntax for this 
operation is: 

Data.Item(natne) 
For example: 
5 savedValue = DataJtemCValOl") 

Data.Remove 

Removes an item from the global data repository. The syntax for the operation is: 
Data.Remove(name) 
10 Data.couiit 

Returns the nimiber of user-defined variables in the global data repository 
collection. 

In addition to providing a global repository of data, in which stored variables 
and data references remain persistent across page changes, the data source connector 
15 also provides local storage to display pages. Data stored in the local database only 
exists during the life of the display, and is accessible by any object in the display. The 
names of items in the local database are only visible to the display using them. 

A display's local database possesses the same fixnctionality as the global 
database. It is accessed using the Data.Local sub-object, using the same ftmctions as the 
20 global database. For example: 

Data.LocaLAddCVal01", 97.2) 

Data.Local.ItemCVal01") 

Data.Local.Remove("entity 1 ") 

Data.Local.count 

25 

The Hendrix architecture also provides the ability to bind to data items in the 
data repository. This is accomplished via the normal data binding mechanisms, with 
the implication that the global data repository functions as a data source component, 
managed by the data source manager. This aspect of the architecture is illustrated in 
30 Figure 25. 

The binding definition for an object bound to data in the data repository is 
relatively straightforward. For example: 
<BODY> 
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<SPAN ID="Alphal" CLASS='THendrix; PlantscapeComtnands" 
BINDINGDEF="AlphalBmdmgDef'> 

</SPAN> 

<HENDRIX:BINDINGDEF ID="AlphalBindingDef' > 
5 <DATA ID="DataRefl" REF="Data.Item( ValOl ')"/> 

<BINDING SOURCE="DataRefl" 
TARGET="PageElement,ImierHTML"/> 

<vUENDRIX:BINDE^GDEF> 
<BODY> 

10 

The global data repository also allows the user to store references to process 
data, which, when retrieved by a display page, reflect real process variables in a target 
system. For example, there are circumstances where a user requires to store the value 
of LCN.AIOO.PV in the display database variable "varOl", and have this variable 

15 updated automatically to reflect the value of the process variable. This process is 
substantially different from the ability to store simple values. 

As described above, the data repository behaves like a data source component 
when it comes to simple values. For data references, however, this is not the case. Data 
references must continuously retrieve data from the server system, thus placing a load 

20 on bandwidth. As items in the data repository are globally persistent, this means that 
valuable bandwidth could be taken even when no displays are loaded on a machine. 
This is clearly undesirable. Ideally, data should only be being gathered by data source 
components when that data is required in some form by a currently loaded display. 
To realise this optimisation, the data repository does not behave as a data 

25 source component for data references, but as a data source dictionary. It provides a 
dictionary service to the data source manager^ which in turn allows data source 
components to achieve a fonn of data indirection when the page is loaded. Tliis 
facility is explained elsewhere in the specification. To a user, however, the ability to 
access data references appears no different from the ability to access simple values in 

30 the repository, as explained below. 

Data references are stored in a similar way to simple variables, through a set of 
three methods (AddRef, ItemRef, RemoveRef) and one property (countRef). These 
ftmction as follows*: 
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Data.AddRef 

Adds a new item, in the form of a named variable, to the display database. The 
syntax for this operation is: 

Data.AddRef(name, value [, xml_data ]) 
5 where name is a string, and value is a string name representing either a 

parameter or an entire object in the data source object model. If an entire object, it is 
assxmied any properties or sub-objects are implicitly included in tlie display database. 
For example: 

Data.AddRef("val01", 'TCN,A100.PV") ' parameter reference 
10 Data.AddRefCVal02", "LCN.A100") ' entity (or object) reference 

The optional parameter, xml_data, is an XML structure defining server-specific 
information pertaining to data collection (e.g. update rates, collection groups, etc). 
DataJtemRef 

15 Returns the specified item from the display database. The syntax for this 

operation is: 

Data.Item(name) 
For example: 

savedValue = Data.ItemRef("val01") 
20 savedValue2 = Data.ItemRef(* Val02").PV 

Some data source components may have pre-defined server-specific entities 
intended to represent certain aspects of the server system. As data references are 
stored as strings, any syntax may be used to reference these items. For example: 
25 Data.IteniRef("val03", "LCN.$AL_ENTY") ' server-specific entity, 

Data.RemoveRef 

Removes an item from the display database. The syntax for the operation is 

Data.RemoveRef(name) 

Data.countRef 

30 Returns the number of user-defined data references in the display database 

collection. 
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Display page objects are also, in some cases, bound to references in the data 
repository, the same as simple variables. For example, the following binding 
definition is used to bind an object to the data reference stored in the item "valOl": 
<BODY> 

5 <SPAN rD="Alphar' CLASS="Hendrix; PlantscapeCommands" 

BINDINGDEF="AlphalBindingDef'> 
<ySPAN> 

<HENDRIX:BINDINGDEF ID-"AlphalBindingDef' > 

<DATA ID-"DataRefl" REF="Data.ItemRef(ValOr)"/> 
10 <BINDING SOURCE="DataRefl " 

TARGET='TageElement.InnerHTML"/> 

</EIENDRIX:BINDINGDEF> 
<BODY> 



15 As mentioned previously, the data repository does not actually store references 

to data, in an attempt to reduce possible bandwidth usage. Instead, it supplies a 
dictionary of reference information that the data source manager uses to look up when 
a page is loaded. A typical sequence is as follows: 

1 . Initial display stores a reference to "LCN. Al 00 .PV" in the data 
20 repository reference "valO 1 

2. Subsequent display is loaded, with a reference to "Data.ItemRef('val01 
in its data definition, along Avith the usual fixed data references (e.g. LCN.A101.PV). It 
passes this data definition to the data source manager. 

3 . The data source manager detects that an indirect data reference through 
25 the data repository is required. It queries the data repository to resolve this to a reference 

to actual data. 

4. The data source manager then hands the fully-resolved data source 
definition to the appropriate data source, which then constmcts its part of the data 
source object model. 

30 5. The binding engine binds directly from the data source component to the 

page. No binding is performed from the data repository to the page. 

Figure 26 schematically illustrates the sequence of events upon page caUup. 
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In this scenario, djniamic data is only retrieved by a data source component 
when it is required by a page. When the page is unloaded, the data source component 
unloads any referenced data from its object model. The only persistent data is the 
dictionary lookup information in the data repository that maps "valOl" to 
5 "LCN.A100.PV". 

This process results in efficient use of communications bandwidth between data 
source components and their respective servers. It does, however, bring into question 
tiie issue of performance. For systems where the mapping between human-readable 
data reference name and actual machine identifier is slow, a performance penalty will be 

10 paid every time a page is loaded. This performance penalty is avoided by allowing the 
data repository to store pre-binding information along with the dictionary item. 

This concept is similar to the ability to perform a pre-binding step in the 
builder. For data defined at build time, the data source component supplies a service 
to the builder which translates the human readable data tags into machine identifiers. 

15 This server-specific information is then stored with the data definition, and passed to 
the data source component at runtime to enable fast callup of the page. In the case of 
the data repository, the situation is similar. When the data reference is first defined 
(via a call to Data.AddRef), the data source manager queries the data source 
component for any pre-binding information it may supply. This pre-binding 

20 information is then stored in the repository along with the dictionary item. On page 
callup, when the data reference is actually required, the pre-binding information is 
p^sed to the data source component in order to ensure fast retrieval of the data. 

At runtime, it is possible for a display to change the reference stored in the data 
repository. In the above example, with a page element bound to "LCN.AIOO.PV" via 

25 indirection through "valOl" in the repository, the following script code is executed on 
the display: 

Data.AddRefCVal01", "LCN.A200.PV") 
This script not only alters the dictionary reference stored in the repository, but 
also re-bind any page elements currently bound to LCN.AIOO.PV to LCN.A200.PV. 
30 This impUes the following capabilities of the architecture: 

1 . The data source component must be able to incrementally add 
LCN.A200.PV to its object model. 
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2. The data repository must be aware that page objects are cxirrently 
bound to objects in the data source object model via an indirection through "valOl", 
and inform the data source manager when its value changes. 

3. The binding engine must be able to dynamically re-bind to the new 
5 data element. 

Dynamic binding (in which bindings between data objects and page elements 
are modified at runtime) differs from static binding (in which bindings are defined at 
build time and created when the page is initially invoked). To achieve dynamic 
binding, the binding engine exposes the IHendrixDynamicBinding interface. The data 
10 source manager uses this interface at runtime to tell the binding engine to set up a 
binding between data and a new object in the display database. 

Popup window functionality differs slightly from more generic inter-display 
communication, in that the invoked popup window generally encapsulates specialized 
functionality, and is expected to behave differently on screen from a normal display 
15 window. Examples of this include faceplates, where extra functionality is required to 
determine which faceplate to invoke, as well as complex lifetune management for 
push-pin type popup windows. 

The invocation of popup windows involves several distinct areas of 
functionality, each of which imposes requirements on the Hendrix architecture: 
20 Identification 

A standard method is required for identifying which popup window needs to 
be invoked. In the case of faceplates, this will depend on the currently selected object, 
or tag name in the system. 

Invocation 

25 The architecture must accommodate a standard method for the invocation of 

popup windows. 

Position management 

In some systems, operators are accustomed to activating a large number of 
modeless popup windows. When multiple displays are shown on a single machine, 
30 some way must be provided to manage these popup windows. 
Lifetime management 
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Popup windows must have the abiUty to be "push-pinned", so that they axe not 
terminated when the originating display changes. The architecture must provide 
Ufetime management services to faciUtate this functionaUty. 

Preferences 

5 The TPA system requires the abiUty to "store" an arrangement of faceplates for 

a display, so that when the operator returns to that display the arrangement of 
faceplates reappears in the configured positions on screen, without having to be 
invoked individually by the operator. 

The above hmitations are now discussed in more detail with reference to the 
10 way in which the preferred embodiments of the invention accommodate these 
limitations. 

The ability to identify which faceplate to invoke for a given point or tag, or 
object on a display, must be accessible from script, and also activated inherently as 
part of the architecture (for example, when a screen object is double-clicked). 
15 First consider the scripting case. When the point name is known, the associated 

faceplate name is retrieved by a simple call on the data source connector: 
faceplateName = Data.getFaceplate(point_name) 
where both point_name and faceplateName are strings. The point identifier 
must be fully qualified, in that it identifies the data source on which the point resides 
20 ("LCN.AIOO", for example). The faceplate name is a URL. 

At times, however, the point name will not be known, and the user will want to 
determine the faceplate associated with an HTML element directly. This functionality 
is provided by the same method on the data source connector, only taking a reference 
to an element in the DOM instead of a string: 
25 faceplateName = Data.getFaceplate(element) 

The element is specified directly via the element ID, or by specifying its 
position in the DOM (document.groupl.textl, for example). 

The above methods provide the ability to identify a faceplate name via script. 
In general, however, it is preferable that faceplate invocation is not handled through 
30 script on a page (as it would then need to be written for every object on that page), but 
instead as an inherent part of the architecture. This capabihty is provided by a binary 
HTML behaviour, which is then appUed to all objects on a page. The behaviour is 
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then responsible for the method of invocation (right-click, double-click, etc.), for 
identifying which faceplate to invoke, and the invocation itself. 

In the case of a binary behaviour, the method used to retrieve the faceplate 
name is still the same: method calls on the data source connector. It is envisaged that 
5 the faceplates are invoked as part of a converged user interface, although as to how 
these behaviours are standardized across all Hendrix implementations is not relevant. 
This is a matter for the style guide and has no impact on the architecture. 

Note also that this method of faceplate identification places specific 
requirements on the architecture components, as follows: 
10 1 . The data source connector must expose the getFaceplate method call. 

2. The data source manager, and specific data source components beneath it, must be 
able to map a point name to a faceplate name, to enable the first type of call to 
getFaceplate to work. 

3. The binding engine must be able to provide a backward mapping from an object in 
15 the DOM to the data object which is driving it. The data source component, 

subsequently, must be able to map this data object into a point name, to honour the 
second type of call to getFaceplate. 

There are two types of popup window generally required to be called from 
script - faceplates representing point details, and data entry dialog boxes intended to 
20 return information to the calling window. These are each invoked in different ways. 

A dialog box is either modal or modeless. A modeless dialog box, constructed 
from HTML, is no different from activating a separate display window. In the pure 
HTML world, this would be accomplished by a call to window.open, with parameters 
used to specify that no toolbar, menus, etc are required in the invoked window. In the 
25 Hendrix architecture, this is accomplished with a call to Data.create Window. The 
data source connector needs to be aware of its environment, to decide whether to 
create the window in a browser window or an appropriate framework window. The 
need to be able to create a modeless dialog window, however, adds extra requirements 
to the create Window method, namely that it accepts the same parameters as the 
30 window.open method, allowing the creation of modeless dialog boxes in the web 
browser environment. Thus the full syntax of the createWindow method is: 
window2 = Data.createWindow(URL [, parameter__string 
[, name 
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[, features 

[, replace ]]]]); 



where URL and parameter_string are explained above, and name, features, and 
5 replace are the same as the parameters used in the window.open method. Information 
is passed between the dialog box and the calling window as described above. 

To create a modal dialog box in a normal HTML page, the 
window. showModalDialog method is called. Similar to the case for opening separate 
windows, however, the appearance of the invoked modal dialog depends on the 
10 environment in which it is invoked. In the browser environment, it is acceptable to 
display the standard Intemet Explorer dialog, but in the operator enviromnent a more 
custom frame may be required. Thus the data source connector exposes the following 
method: 

variant = Data.showModalDialog(IIRL [, vArguments [, sFeatures]]) 
15 Here the parameters are the same as those used in the 

window. showModalDialog method - the only difference is that the frame used for the 
invoked dialog box is dependent upon the environment. 

Faceplate windows are different, in that a faceplate has no parallel in the 
HTML world. The frame window used for faceplates includes, for example, a 
20 pushpin button to allow faceplates to be kept on the desktop even as the underlying 
page changes. The frame window used for faceplates will be the same in both web 
browser and operator environments. Faceplates themselves will be created in HTML. 

The invocation of a faceplate is executed as a method call on the data source 
connector. This call often takes multiple forms: 
25 Avindow2 = Data.showFaceplate(sURL [, parameter_string [, sFeatures ]]) 

whidow2 ~ Data.showFaceplate(point_name [, parameter_string [, sFeatures]]) 
window2 = Data.showFaceplate(object [, parameter_string [, sFeatures ]]) 

The first of these calls simply specifies the faceplate filename (which may 
30 have been previously retrieved by a call to getFaceplate), and an optional display 

parameter string, using the same method outlined for passing parameters as mentioned 
above. It also accepts the optional parameter sFeatures, which is used to specify 
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position information on screen, and is identical to the parameter of the same name in 
the showModalDialog method in the DOM. 

The second method passes a string specifying a point name. In this method, 
the showFaceplate call is responsible for determining which faceplate to invoke, 
5 removing the need for the user to call getFaceplate separately. 

The third method also removes the need for a separate call to getFaceplate. In 
this case, an object in the DOM is passed as a parameter, instead of a string specifying 
a point name. Again, the data source connector is responsible for determining which 
faceplate to show, and then invoking that faceplate. 

10 Position management is an issue for faceplates in the TPA system, where 

faceplates move when the main display window is moved, minimise when the main 
window is minimised, and are constrained to the cUent area of the parent window. 
This is not an issue for most other systems (GUS utilizes its own desktop management 
system in SafeView, for example, and PlantScape conforms to the standards used in 

15 Microsoft products, where a modeless push-pinned dialog is moved independently of 
its parent window). For a system utiUzing a large nimiber of faceplates displayed at 
any one time, however, such as TPA, these solutions are not sufficient, and some form 
of position management system is required. 

Almost any type of faceplate window behaviour can be achieved, as long as the 

20 faceplate window has access to the window handle of its intended parent If the 
faceplate declares itself as an MDI child window, it Avill behave as such, even if the 
parent is not an MDI application. This is the case for TPA faceplates. If the faceplate 
declares itself as a normal child window, it wiU minimize with the parent window, but 
not be constrained to the parent cUent area. And if the faceplate is a normal window, 

25 but sets its parent window to the calling display, it will minimize with the parent, but 
not be constrained to the parent client area, and move independently of the parent. 

The key to this functionalify is obtaining the window handle (HWND) of the 
application containing the calling display. This is simple in the operator environment, 
as the data source component (which creates the faceplate in its showFaceplate 

30 method) is able to obtain this window handle from the framework. In the browser 
environment, however, this is not possible. This constitutes yet another differentiator 
between the two environments - faceplates are not as easy to manage in the browser 
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environment. As faceplates are generally associated with process-control type 
functions, this is an acceptable compromise. 

The mechanism used by the data source connector to set the parent window on 
the invoked faceplate is simply as a property set on the faceplate object — it must 
5 expose the parentHWND property to be set by the data soxirce connector* It is up to 
the faceplate object to decide how it uses this window handle, which in turn dictates 
its behaviour. (It will be quite feasible to build a generic faceplate container, which 
depends on information in the individual faceplate HTML definition to decide which 
behaviour to exhibit. Thus TPA faceplates could function differently firom PlantScape 

10 faceplates, while still using a single faceplate container window). 

Lifetime management of faceplates is an issue in the case of the pushpin 
functionality required by the TPA system. Normally, when a faceplate is invoked, it 
is destroyed when the operator changes displays. If the faceplate is "pinned", 
however, it will remain visible across page changes. If it is subsequently "unpinned", 

15 the next page change will destroy the faceplate. The mechanism used in Hendrix to 
inform faceplates of page changes is as follows: 

1 . The data source connector on each page retains pointers to each 
faceplate object it has invoked. 

2. Upon page change, the data source connector informs each of these 
20 faceplates that the page is changing. 

3. The faceplates return a result to the data source connector indicating 
whether they have destroyed themselves or not, depending on their pushpin state. 

4. The data source connector updates its array of pointers to indicate the 
remaining faceplates, then persists this information so that it can be retrieved by the 

25 data source coimector on the new display. (The ability to persist COM pointers across 
page changes is already possessed by the data source connector, as connection 
information also needs to be persisted across page chauges, so that a new page can 
connect to the same data source as the previous page), 

5. The data source on the new page retrieves the pointers to the faceplates it 
30 needs to manage, so that it can subsequently inform them when it is being destroyed. 

Preferences, where they pertain to faceplates, concern the ability of an operator 
to define a set of faceplates that they want to be called up each time a particular display 
is invoked. This is done in a similar way to the Ufetime management of faceplates. The 
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data sovirce connector on a page already retains an array of pointers to the faceplates it 
has invoked. When asked to persist preference information, it requests configuration 
information from these faceplates (such as position, point name, etc.), then persists this 
information in a structured XML data store. This information is stored on a per-user, 
5 per-display basis. It then exposes a method, showPreferenceFaceplates, which will 
retrieve this information and invoke the faceplates, in the required positions, as required. 

In summary, then, the last three functionalities impose certain requirements on 
both the data source connector and the faceplate object as used in the preferred 
embodiments. These requirements are as follows: 
10 • The faceplate object must expose the queryDestroy method, which is called by the 
data source connector when it is being unloaded. This method returns a value 
indicating whether the faceplate did, in fact, destroy itself. (The faceplate must also 
expose a destroy method, which destroys the faceplate regardless of pushpin state.) 

• The data source connector must expose the showPreferenceFaceplates method. 
15 • The data source comiector must expose the persistFaceplatePreferences method, 

which will cause it to query all open faceplates for their position information, and 
store this information in structured XML data. 

• The faceplate object must expose methods which returns configuration information 
(such as current position on screen, as set by the operator, and current point name). 

20 The data soiirce connector calls these methods when storing faceplate preferences. 

• The faceplate object must expose the parentHWND property, which, when set, it 
will use to create itself as a child of that window. 

The following features are set out to provide the addressee with some 
additional insight into the architecture of the preferred embodiments. 
25 IHendrixBinding 

[ object, uuid(l 1877500-CA13-1 1D2-B6EA-00C04FF010A0) ] 
interface IHendrixBinding : lUnknown 

{ 

//TBD 

30 }; 



IHendrixBinding is implemented by the binding engine's internal binding 

objects. 



wo 01/95041 



PCT/AUOl/00706 



-85- 

IHendrixBmdingEngineCache 

[ object, uuid(11877501-CA13-llD2-B6EA-00C04FF010A0) ] 
interface IHendrixBindingEngineCache : lUnknown 

{ 

5 HRESULT FlushO; 

HRESULT QueryMode([out]BOOL *pbCaclieOn); 
HRESULT SelMode([in]BOOL bCacheOn); 

}; 



10 IHendrixBindingEngineCache is implemented by the Hendrix data binding 

engine to allow data sources to control the binding engine's transmission cache. This 
cache is used to buffer updates to the display page to minimize round trips between 
the binding engine and the display page. 
mendrixCoUection 
15 [ object, uuid(l 1877502-CA13-1 1D2-B6EA-00C04FF010A0) ] 

interface IHendrixCollection : IDispatch 

{ 

>; 

20 IHendrixCollection is implemented by collection subobjects. It is an empty 

interface used as a type indicator for the binding engine navigating the object model 
via IHendrixDataRef. 

IHendrixConnectionPoint 

[ object, uuid(11877503-CA13-llD2-B6EA-00C04FF010A0) ] 
25 interface IHendrixConnectionPoint : lUnknown 

{ 

HRESULT Comiect([in] riid, 

[in, iid_is(riid)]IUnknown *pNotifySink, 
[out]DWORD *pdwCoolde); 
30 HRESULT Disconnect([in]DWORDdwCookie); 

}; 
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IHendrixConnectionPoint is an improved version of the standard connection 
point mechanism. It requires only one transaction to establish the connection, 
IHendrixDataRef 

[ object, uuid(11877504-CA13-llD2-B6EA~00C04FF010A0) ] 
5 interface IHendrixDataRef : IDispatch 

{ 

typedef struct 
{ 

REFIID did; 

10 [iid_is(riid)]IUiiknown *pSubObject; 

} SUBOBJ; 



HRESULTGetSubObjectsO£Names([in,size_is(cNames)]OLECHAR 
**rgszNames, 

15 [injunsigned int cNames, 

[in]LCID Icid, 

[out,size_is(cNames)] SUBOBJ *rgSubObjects); 

}; 



20 IHendrixDataRef is implemented by objects in the data source object model. 

It is an extension of the standard IDispatch interface that allows the object hierarchy to 
navigated more quickly. 

IHendrixDataSource 

[ object, uuid(11877505-CA13-llD2-B6EA-00C04FF010A0) ] 
25 interface IHendrixDataSource : lUnknown 

{ 

HRESULT Imt([in]IHendrixBindingEngineCache *pCache, 
[in]IStreain *pBindingDefStreatn, 
[out]IHendrixDataRef * *ppDataSourceRoot); 
30 HRESULT StartO; 

HRESULT StopO; 

}; 
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IHendrixDataSource is the main interface exposed by a data source. It allows 
the data source manager to initialize, start and stop the data source. 
IHendrixDataSourceManager 

[ object, uuid(11877506-CA13-llD2-B6EA^00C04FF010A0) ] 
5 interface IHendrixDataourceManager : lUnknown 

{ 

//TBD 

}; 

10 IHendrixDataSourceManager is the main interface exposed by the data 

source manager. It is used primarily by the data source connector in the display page 
and by any run time frameworks managing display pages. 
IHendrixNotifySink 

[ object, uuid(l 1877507-CA13-1 1D2-B6EA-00C04FF010A0) ] 
15 interface IHendrixNotifySink : lUnknown 

{ 

HRESULT OnChange([in]DISPID dispid, 
[injVARIANT newVal); 

}; 

20 

IHendrixNotifySink is implemented by the binding engine's intemal binding 
objects. It is used by data reference objects to notify the binding engine of changes to 
property values. 

The next part of this docimient provides a description of the Hendrix data 
25 source architecture. In particular, it describes the components and interactions 
relevant to any data source implementation. There is provided an overview of the 
architecture and how data sources relate to the rest of the Hendrix architecture as well 
as a description of the components that comprise a data source in detail including ' 
required interfaces and interactions with other components, 
30 This docimient focuses on the implementation of Hendrix data sources. A data 

source is a component that exposes data, events and methods provided by a specific 
server system to the Hendrix data binding engine. The data binding engine then 
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provides the means by which these data, events and methods are boxmd to the 
presentation elements in a display page. 

A data source provides a means of encapsulating all of the mechanisms 
required to access a server system from an HMI. It encapsulates the mechanisms for 
5 establishing and securing connections to a server system, delivering data to and from a 
server system, delivering events from the server system to the HMI and invoking 
methods on the server system from the HMI. 

A data source implementation of the preferred embodiments actually consists 
of two main parts. The first is the data source component itself, which is responsible 
10 for the overall operation of the data source such as establishing connections to server 
systems and persistence of the data source. The second part is a hierarchy of data 
objects, called the data object model, which exposes the server system data, events 
and methods to the Hendrix data binding engine. The data source component also acts 
as the root of the data object model. Figure 27 illustrates the general arrangement of 
15 the Hendrix data source architecture. 

A Hendrix user interface framework hosts one or more display pages. A user 
interface framework uses the services of a Hendrix data source manager to manage a 
set of data sources that supply data to the display pages it hosts. The data source 
manager provides an execution environment for data sources that includes a number 
20 of services that they require in order to provide efficient, secure access to data. 

Hendrix data sources, as used in the present embodiments, are in-process COM 
objects. They belong to the Honeywell Data Source component category identified by 
the following GUBD. 

CATID_HDXDataSource - {E2156A20-640F-lld3-B766-00C04FF010A0} 
25 This component category is used by interested parties (e.g. the Hendrix display 

builder) to learn what data source implementations are available on a system. 

Figure 28 illustrates the components that constitute a data source, the main 
COM interfaces they implement and the main relationships they have with other parts 
of the Hendrix architecture. 
30 The only externally createable object in a data source implementation is the data 

source factory. The data source factory is a regular COM object (not a class object) that is 
used to manufacture instances of a particular data source implementation. The data 
source factory is cached by the data source manager for the lifetime of the data source 
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manager and provides an opportunity for a data source implementation to share resoiirces 
such as network connections between data sources (concurrently and serially). A regular 
COM object is used rather than a COM class object to enable data sources to be 
implemented in Visual Basic. The data soiu'ce factory implements 
5 IHDXDataSourceFactory, which is used to manufacture a new data source instance. 

The main COM interfaces implemented by a data source are IHDXDataSource 
and IHDXDataObject. IHDXDataSource allows the data source manager to access 
the methods that control the overall operation of the data source. IHDXDataObject 
allows the data source manager to access the methods used to control individual data 
10 objects in the data object model. 

Data sources and data objects implement a number of other COM interfaces to 
complete the functionality required by the data source manager and clients of the data 
source manager. These interfaces are described in further detail below. 

Hendrix data sources expose a set of standard properties that control their 
15 behaviour in various circumstances. There are currently two standard properties 
defined, these are "SimulatedData" and "QualityOfService". 

SimulatedData is a boolean property whose value indicates whether or not the 
data source should deliver real or simulated data. Typically, SimulatedData is set to 
TRUE when the chent of the data source manager is the Hendrix Display Builder and 
20 set to FALSE when the client of the data source manager is a run time framework. 

QualityOfService is an enumeration that indicates to the data source what 
quality of service is desired. Control room operators would typically require a high 
quality of service, while a lower quality of service might be adequate for more casual 
users. 

25 It is up to each data source implementation to decide exactly how it will 

respond to the various values of these properties. It is expected that this set of 
properties will expand over time and the architecture allows for this expansion. More 
information on standard data source properties is provided below. 

Each data source has a site object through which it accesses a variety of 

30 services. These services are exposed as a set of ambient properties accessible via 

IDispatch on the site object. The services provided by the site object currently include 
a datd transfer service, a security service and an error logging service. 
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The data transfer service allows a data source to register data objects with the 
Hendrix binding engine and to control the transfer of data through the binding engine. 
The data transfer service is accessible through the 'TDataTransfer" ambient property. 
Additional details on the data transfer service are provided below. 
5 The security service allows a data source to discover the credentials of the user 

currently logged on to the user interface framework and to receive notifications of 
changes to those credentials. The credentials are available through the "Usemame" 
and "Password" ambient properties and the notification service is available through 
the "Security" ambient property. Further details about Hie security service are 
1 0 provided below. 

The "Error" ambient property can be used to access the error logging service, 
and is described further below. 

The data object model is the means by which a data source exposes individual 
server system data items to the Hendrix data binding engine. Each data object is in 
15 essence a conduit through which data and events are delivered from the server system 
to the user interface and data and method invocations are delivered to the server 
system from the user interface. Data objects are arranged in a hierarchy rooted at the 
top level data source object. 

Data objects typically have a set of properties that control what data is to be 
20 delivered and how to deliver that data and are referred to as configuration properties. 
The set of configuration properties constitutes the persistent state of a data object and 
a data object provides property pages to allow these configuration properties to be 
configmred. The most common client of these property pages v^U be the Hendrix 
display builder. Configuration properties typically include the name of tiie server 
25 system data item to be delivered by the data object. The IHDXName interface is used 
as an abstraction of the details required to specify such names. 

Data objects also have a set of properties that expose the actual server system 
data that is to be bound to a display page. These properties are referred to as dynamic 
properties. Dynamic properties also support data binding (that is, they are marked as 
30 [bindable] in a type library). This means that a data object will issue a property 

change notification via IPropertyNotifySink whenever a dynamic property changes. 

Some properties belong in both sets, that is, they are used to configure the 
deUvery of data in the builder and are bound to a display page at run time. 
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A data object also defines an outgoing interface if it supports events. Events 
are fired into the binding engine using an implementation of IDispatch provided by 
the binding engine. 

Since many server systems contain different types of data items, data object 
5 models contain different types of data objects. These types expose the data, events and 
methods relevant to the various types of underlying server system data items. Data 
object types are identified using a syntax similar to COM programmatic IDs (proglDs). 

The number and type of data objects in an instance of a data object model are 
generally determined by the data requirements of the particular display page that the 
10 instance services. The user determines these requirements as the display page is 
constracted. 

The actual interface between data objects in a data source and the Hendrix data 
binding engine is based on the standard COM Automation mechanism. This makes it 
relatively easy to build data objects using standard COM enabled tools such as ATL, 
15 Visual Basic and J++. 

In addition to the configuration and dynamic properties discussed above, a data 
source also provide properties and methods for navigating the data object model. This 
enables the data object model to be scripted using standard ActiveX scripting engines. 

The following automation compatible types are used for properties and method 
20 or event arguments on data objects. 

VT_UI1, VTJ2, VT_I4, VT_R4, VT_R8, VT^CY, VT^DATE, VT_BSTR, 
VT_VARIANT, VT^BOOL, VTJvTULL, VT_ERROR 

Safe arrays of these types are also supported (that is, VT_ARRA.Y | *). 
25 B Y_REF properties are not supported. 

There are two general cases in which a data source will be persisted. The first 
is saving the configuration of the entire data source to allow efficient reloading at a 
later time. The most common scenario will be saving the data source configuration 
after the data source has been modified by the Hendrix display builder and then 
30 loading the configuration when a display page is called up in an operator firamework. 

The second case is when individual objects in a data source are persisted 
independently of one another. This occurs primarily when the Hendrix display builder 
is performing clipboard operations such as cut, copy and paste. 



wo 01/95041 



PCT/AUOl/00706 



-92- 

The first case requires that there be an implementation of IPersistStreamlnit 
that saves and loads the entire data source state to and from a stream provided by the 
data source manager. Perfomiance is of paramount importance in this case so data 
sources should use a stream format that allows them to load as quickly as possible. 
5 This format often contains additional information derived during data source 
validation in order to faciUtate speedy loading. 

The second case requires that all data objects in a data source support the 
persistence interfaces IPersistStreamlnit as a minimum and preferably 
IPersistPropertyBag. In this case performance is not as critical and any convenient 

10 stream format is used. 

Since all data objects including the root data object are required to implement 
persistence interfaces to support clipboard operations there needs to be a separate 
implementation of IPersistStreamlnit that is used to serialize the entire data source. This 
implementation is retrieved via a call to IHDXDataSource::GetPersistenceHelper. 

15 Data objects exist to deliver data from server systems. An important part of 

configuring a data object to deliver data is the specification of exactly what data to 
deliver. It is important to realize that the identity of the data object is not the same as 
the identity of the server system data item that it delivers to the binding engine. 

Many data objects are associated with one and one only server system data 

20 item. In this case there is a single name property on the data object. It is also possible 
for a data object to have more than one server system name associated with it. An 
example of this might be a data object that provides an array of historical data for a 
number of point parameters. In this case there would be one name property for each 
point parameter. Such a data object might be used to drive a trend object. 

25 Typically, the user of the Hendrix display builder provides these names. 

Before a user enters a name the user has to discover what names are available and then 
choose one. The two main mechanisms for this are to "remember and type" or to 
provide a namespace browser mechanism that allows the user to navigate a server 
system's namespace and select names directly from that namespace, 

30 In either case, the process is greatly assisted by providing knowledge of the 

type of named object required. For example, if a data object is designed to deliver 
PlantScape point parameter data, the browser is constrained to show only names of 
PlantScape point parameters. 
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The IHDXName interface is designed to encapsulate both a server system name 
and the type of the named object. A data object that requires server system names as 
part of their configuration exposes one or more sub-objects that expose the IHDXName 
interface. The builder uses IHDXName: :get_Type to constrain the namespace browser 
5 or prompt the user. IHDXName: :put_Name is then used to set the name. 

When data objects are arranged in a hierarchy, the name properties on the data 
objects are preferably partial names that, when taken together, form a complete name. 
La such a case IHDXName: rgetJSTame would return the partial name and 
IHDXName: :get_FullName would return the complete name up to that point in the 
10 hierarchy. 

Since a user's primary interest is not in the names of the data objects but in the 
names of the server system data items that they deliver, there needs to be a way of 
mapping from server system names back onto data objects. This is required when a 
user wants to access a data object from script code and will probably not even be 

15 aware of the identity of the data object itself. In this case the user supplies the name 
of the server system data item and the system queries the data objects for one that 
knows about the requested name. 

IHDXDataObject::GetPrimaryName is provided to allow the binding engine to 
query a data object for the name most Ukely used by a user to identify it. In the case 

20 of data objects with a single name property it is simply that single name property that 
is returned. In the case of a data object with more than one name property, the data 
object nominates one of these to be the primary name. 

The following part of the specification describes the interfaces that are 
implemented on data sources and data objects. Particularly, the following table lists the 

25 interfaces implemented by Hendrix data sources. 



INTERFACE 


OPTIONAL 


IHDXDataSovirce 


No 


IHDXDataObject 


No 


IHDXDataSourceValidation 


Yes 


IHDXSecurilyNotify 


Yes 


lObjectWithSite 


Yes 


Idispatch 


Yes 
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ISpecifyProp ertyP ages 


Yes 


IPerPropeiiyBrowsing 


Yes 


IPersistStreamlnit 


Yes 


EPersistPropertyBag 


Yes 


ISupportErrorlnfo 


Yes 



IHDXDataSource Validation is only required by data sources that support the 
validation of their configuration. 

IHDXSecurityNotify is only required by data sources that need to be kept 
5 informed of changes to the current user's security credentials. 

IDispatch, IProvideClassInfo2, ISpecifyPropertyPages and 
IPerPropertyBrowsing are required only if the data source object itself has persistent 
build mode properties. 

IPersistStreamlnit or preferably IPersistPropertyBag is required if the data 
10 source object has any persistent configuration properties. 

ISupportErrorlnfo is optional but the data sources of the preferred embodiments 
implement this interface so that they provide detailed error information to the data 
source manager in the event that a method in one of the above interfaces fails. 

The following table hsts the interfaces implemented by Hendrix data objects. 



Interface 


Optional 


IHDXDataObject 


No 


IConnectionPointContainer 


Yes 


IConnectionPoint 


Yes 


IDispatch 


Yes 


IProvideClassInfo2 


Yes 


ISpecifyPropertyPages 


Yes 


IPsrPropertyBrowsing 


Yes 


IPersistStreamlnit 


Yes 


IPersistPropertyBag 


Yes 


ISupportErrorlnfo 


Yes 
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The only mandatory interface on a data object is IHDXDataObject. If the data 
object does more than simply contain other data objects it will need to implement 
some or all of the other interfaces listed above. 

Data objects that deliver data to the Hendrix data binding engine implement 
5 IComiectionPointContainer, IConnectioiiPoint, IDispatch and IProvideClassInfo2. 

ISpecifyPropertyPages and IPerPropertyBrowsing are required only if the data 
object has configuration properties. 

IPersistStreamlnit or preferably IPersistPropertyBag is required if the data 
10 source object has any persistent configuration properties. 

ISupportErrorlnfo is optional but it is recommended that data sources 
implement this interface so that they provide detailed error information to the data 
source manager in the event that a method in one of the above interfaces fails. 

This following part of the specification describes the general operation of 
15 Hendrix data sources. Two common scenarios are considered in detail. Firstly, data 
source operation when the client of the data source manager is an operator framework 
is considered followed by the case where the client of the data source manager is the 
Hendrix display builder. 

Note that these are two common scenarios, not the only possible scenarios. 
20 For example, in other embodiments, the Hendrix builder is connected to and starts a 
data source to provide a live preview mode. 

Figure 29 illustrates the typical data source states and the methods that cause 
transitions between those states when a data source is being used to provide data to a 
run time UI fi-amework. This is also referred to as run mode operation. Figure 30 is a 
25 UML sequence diagram that illustrates the basic operation of a Hendrix data source at 
run time in more detail. 

Data source initialisation commences with the initialisation of the top level 
component with calls lObjectWithSite: iSetSite and IPersistStreamlnit: :InitNew or 
IPersistPersistStreamInit::Load. During initialisation, the root object is registered 
30 with the data binding engine using IHDXDataTransfer: :RegisterDataObject. 

IHDXDataTransfer is accessible through the 'T)ataTransfer" ambient property on the 
site object. Once the root object has been initialised, the data sources are fiiUy 
initialised via the persistence helper object. 
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Connection is initiated via a call to IHDXDataSoiirce: rConnect. The process 
of connecting to a server system can fail, and this typically occurs for one of two 
reasons. The first is that there is a problem establishing a connection to the server 
system. This might be due to network or configuration problems. The second reason 
5 for connection to fail is that the current user does not have authority to view the data 
provided by the data source. The check to verify that a user is authorised to use a data 
source is typically performed by using a combination of the current user's usemame 
and some configuration properties of the data source. For example, a data source 
providing properties that restrict its use to a particular plant area. During connection, 
10 the data source checks that the current user is a member of the specified area. If the 
check fails then the data source returns an error code that distinguishes this 
authorisation failure firom more general connection failures. 

When the data source manager encounters an authorisation failure in one of the 
data sources for a display page, the initiaUsation of all data sources for the display 
15 page is aborted and the user interface fi-amework is alerted to the fact. 

Once a data source has been successfixUy connected it is started. Prior to 
IHDXDataSource::Start being called, the data binding engine will have hooked each 
registered data object up to a sink object that will receive property change 
notifications and events from it. This hookup is performed using the standard 
20 ICoimectionPoint mechanism. 

IHDXDataSource::Start is a signal to the data source to begin dehvering data by 
calUng IPropertyNotifySink::OnChanged and honouring the subsequent call to 
IDispatch: :Invoke by the binding engine to retrieve the changed property value. 
Events are fired into the binding engine by a data object using 
25 IDispatch: :Invoke. 

The data source calls IHDXDataTransfer::Flush to have data updates 
propagated to the display page. This mechanism allows a data source to accumulate a 
batch of data updates before having them applied to the display page in a single 
transaction, thus greatly improving performance of the data transfer mechanism. 
30 IHDXDataTransfer::Flush is implicitl}^ called whenever an event is fired by a data 
source. This ensures that the state of the page is up to date when the display page 
method that the event is bound to is called. 
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When the data source is no longer required, it will first be stopped with a call to 
IHDXDataSource::Stop. The data source is then restarted by another call to 
IHDXDataSource:: Start or un-initialised with a call to IHDXDataSource::Uninitialise. 

During IHDXDataSource: lUninitialise the data source should un-register its 
5 data objects and release the data source site object. 

One of the main jobs of the Hendrix display builder is to construct and 
configure data sources for later use in a run time UI framework. Figure 3 1 illustrates 
the typical data source states and the methods that cause transitions between those 
states when a data source is being used by the Hendrix display builder. This is also 
10 referred to as run mode. 

The main causes of state transitions in build mode are changes to the 
configuration of data source properties. This is indicated by the calls to 
IDispatch: :Invoke in the state transition diagram, although calls to 
IHDXDataObject::CreateObject and IHDXDataObject::DeleteObject cause similar 
15 transitions. These calls occur as the user interacts with the builder to modify the 
configuration of the data sources for a display page. 

In build mode, the "Loaded" is also used as a dirty state, in which the data 
source configuration contains changes that have not been saved 

The "Validation" state is only applicable to data sources that implement 
20 IHDXDataSourceValidation. The call to IHDXDataSourceValidation: : VaUdate is a 
signal to the data source to do whatever it has to do to check that the current 
configuration is valid. This step is also used to generate additional information that is 
used intemally within the data source at run time if the process of generating this 
information is too time consuming to be done diuing the frequently called 
25 IPersistStreamlnit: :Save method. 

Figure 32 is a UML sequence diagram that describes a build mode sequence of 
events in which a new data source is created and configured to have a simple data 
object model consisting of a root data object containing one child data object. 

In this scenario, initialisation consists of calls to and IObjectWithSite::SetSite 
30 and IPersistStreaiiiInit::InitNew. During initialisation the data source registers the 
root data object. 

After instantiation and initialisation the data object model is constructed. 
Object model construction commences at the root object. Data objects (other than the 
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root object) are created by calls to IHDXDataObject::CreateObject() on the container 
of the new data object. As a data object is able to contain data objects of different 
types, a parameter in the IHDXDataObject::CreateObject() call identifies the type of 
data object to create. The builder retrieves a list of types supported by a container by 
5 calling IHDXDataObject::GetCreatableTypes. As an example, the type of a 

PlantScape data object that delivers a point parameter is "PlantScape.PointParam". 

IHDXDataObject::CreateObject returns an ID that is later used to remove the 
data object with a call to IHDXDataObject::DeleteObject. This ID is assumed to be 
imique within the data object model and persistent. It is also used in the call to 
10 IHDXDataTransfer: iRegisterDataObj ect. 

To construct a configuration user interface, the builder uses the standard 
interfaces IDispatch, IProvideClassInfo2, ISpecifyPropertyPages and 
IPerPropertyBrowsing on individual data source objects. 

Once the data object model has been constructed and configured, it is validated 
15 via a call to IHDXDataSourceValidation : .'Validate and saved with a call to 

IPersistStreamInit::Save. Validation, in some embodiments, requires that a transient 
connection to a server system be established. It is the responsibility of the data source 
to save the state of the data source component as well as all of the objects in the data 
object model. 

20 There are two additional services available to data sources that assist their 

operation. The first of these is the security service. The security service provides 
access to the current user's usemame and password via the "Usemame" and 
"Password" ambient properties. These credentials are used to secure a data source in 
any way that is appropriate to a particular data source. It is up to each data source to 

25 verify that these credentials are authentic. 

In addition, a data source is registered with the security service to receive 
notifications of changes to these credentials by calling IHDXSecurity: : Advise. 
IHDXSecurity is accessible through the "Security" ambient property. The data source 
will be notified of changes through a call the IDXSecurityNotify interface 

30 implemented by the data source. 

The second additional service is a logging service that allows data sources to 
write diagnostic and error messages to a central log maintained by the data source 
manager. IHDXError::LogError is used to write messages to the log. 
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IHDXError::RaiseError logs the error in the log file and propagates the error to the 
user interface framework. Each message is assigned a severity level that is used to 
filter the writing of messages to the log. IHDXError is accessible through the "Error" 
ambient property. 

5 Hendrix data sources are implemented using any tool that allows you to 

construct COM objects with the required interfaces. Two common choices will to write 
them in C++ using Microsoft's Active Template Library or in Microsoft's Visual Basic. 
It is also be possible to write a Hendrix data source in Java using Microsoft's J++. 

The Hendrix SDK includes two sample data source implementations, one in 
10 C-H- using ATL and the other in Visual Basic. ATL's fine grained approach to COM 
object implementation makes it possible to pull together a data source and data object 
implementation from the individual implementations of standard COM interfaces 
provided by ATL. The only interfaces for which there are no built in implementations 
are IHDXDataSource, IHDXDataSourceVahdation, IHDXSecurityNotify, 
15 IHDXDataObject and IHDXName. 

If a data source exposes a complex data object model, requires high 
performance operation or wishes to perform complex internal resource management, 
C-H- and ATL are the best implementation strategy. 

Many of the interfaces required on a Hendrix data sotirce are a subset of the 
20 interfaces on an ActiveX control. This means that one implementation strategy is to 
implement the data source and data objects as ActiveX controls. Visual Basic makes 
it easy to construct a Hendrix data source out of ActiveX controls. 

All that needs to be done is to import the Hendrix Data Source type library and 
implement an ActiveX control for the data source and an ActiveX control for each 
25 type of data object in the data source. Implementations of IHDXDataSource, 

IHDXDataSourceVahdation, lEIDXSecurityNotify, IHDXDataObject and IHDXName 
are then added to the controls, as required. 

The Hendrix data source maaager is free threaded, that is, it executes in a 
COM Multithreaded Apartment (MTA). The data transfer mechanism between a data 
30 source and the Hendrix data bmding engine involves a great many method calls, 

especially if the data source supports a complex data object model. For this reason, in 
those embodiments where the data sources require high performance, they are written 
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se that they can also execute in an MTA. This means that they need to be thread safe 

and marked in the registry as ThreadingModel=Both or ThreadingModel=Free. 

It is possible to build a single threaded data source but its performance will be 

less than that of a multithreaded data source due to the presence of an apartment 

5 boundary between the data source and the rest of the data source manager. This may 

not be a serious limitation for many simple data sources. 

This part of the document details the COM interfaces, standard and ambient 

properties and enimierations relevant to the implementation of a Hendrix data source. 

The header file containing these definitions for C++ developers is called HDXDS.H 

10 and the type library for Visual Basic developers is called HDXDS.TLB. These files 

are included in the Hendrix SDK. 

The preferred Hendrix data source interfaces are set out below. 

IHDXDataObject 

IHDXDataObject is implemented by all data objects in a data source's data 
15 object model. 

interface IHDXDataObject : lUnknown 

{ 

HRESULT CreateObject([in] BSTR bstrType, 
[in, out] long* pED, 
20 [out, retval] IDispatch** ppNewObject); 

HRESULT DeleteObject([in] long IID); 

HRESULT GetParent([out, retval] IDispatch** ppParent); 

HRESULT GetID([out, retval] long* pUD); 

HRESULT GetType([out, retval] BSTR* pbstrType); 
25 HRESULT GetCreatableTypes([out, retval] SAFEARRAY(BSTR)* pTypes); 

HRESULT GefPrimaryNaine([out, retval] mOXName** ppName); 



IHDXDataOb j ect : : CreateOb j ect 

30 Creates a new data object as a child of the current object. 

HRESULT CreateObject([in] BSTR bstrType, 
[in, out] long* pUD, 

[out, retval] IDispatch** ppNewObject); 
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Parameters: 

bstrType The type of the data object to create. 
plID The address of where to store the ID used to subsequently 

5 identify the data object. This ID is generated by the data source. 

PpNewObject A reference to the newly created data object. 
Return Code: 

S_OK The method succeeded. 

HDX_E_INVALIDTYPE The container does not support the requested type 
10 of data source obj ect. 

HDX_E_NOTCONTAINER The data object is not a container and 

cannot be used to create further data objects. 
E_FAIL The method failed. 
The ID returned from this function is used in calls to 
15 IHDXDataObject::DeleteObject, IHDXDataTransfer::RegisterDataObject and 
IHDXDataTransfer : lUnregisterDataObj ect. 
The ID needs to be persistent. 

The newly created data object is registered with the Hendrix data binding 
engine using IHDXDataTransfer: iRegisterDataObj ect prior to this method returning. 
20 IHDXDataObject: iDeleteObject 

Deletes the specified data object. 
HRESULT DeleteObject([in]long UD); 
Parameters: 

UD The ID of the object to be deleted. 
25 Return Code: 

S_OK The method succeeded. 

HDX_E _OBJECTNOTFOUND The requested data object did not exist. 
I.e. the ID was not valid. 

HDX_E_NOTCONTArNER The data object is not a container and 

30 cannot container other data objects. 

E_FAIL The method failed. 

If the data object being deleted is a container object then all contained objects 
are to be impUcitly deleted as well. 
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Prior to being deleted, data objects must be unregistered with the Hendrix data 
binding engiae usiag IHDXDataTratisfer::UnregisterDataObject. 
IHDXDataObject::GetParent 

Returns the parent of the data object. 
5 HRESULT GetParent([out, retval] IDispatch** ppParent); 

Parameters: 

ppParent Pointer to the IDispatch interface on the data object's parent. 
Return Code: 

S_OK The method succeeded. 

10 HDX_E JSTOPARENT The data object does not have a parent. This 

would be returned if IHDXDataObject::GetParent was called on the root object. 

E_FAIL The method failed. 

IHDXDataObject: :GetID 

Retums the ID of the data object. 
15 HRESULT GetID([out, retval] long* plID); 

Parameters: 

plID Pointer to the location in which to store the ID of the data object. 
Return Code: 

S_OK The method succeeded. 

20 E_FAIL The method failed. 

The ID returned by this method is the same ID returned by 
IHDXDataObject::CreateObject. 

IHDXDataObject: :GetType 

Retums the type of a data object. 
25 HRESULT GetType([out, retval]BSTR *pbstrType); 

Parameters: 

pbstrType The type of the data obj ect. 
Return Code: 

S_OK The method succeeded. 

30 E_FAIL The method failed. 

IHDXDataObject: :GetCreatableTypes 

Retums a Ust of the types supported by a container object. 

HRESULT GetCreatableTypes([out, retval] SAFEARRAY(BSTR)* pTypes); 
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Parameters: 

pTypes A safe array of BSTRs containing the types of objects that can be 
created by the data object. 

Return Code: 
5 S_OK The method succeeded. 

HDX_E_NOTCONTAINER The data source object is not a container 

object, and cannot be used to create further data objects. 

E_FAIL The method failed. 

IHDXDataObject: :GetPrimaryName 
10 Returns the primary name of the data object. 

HRESULT GetPrimaryName([out, retval]IHDXName **ppName); 

Parameters: 

ppName Pointer to the IHDXName interface on the data object's primary 

name. 

15 Retum Code: 

S_OK The method succeeded. 

HDX_EJSIONAME The data source object does not have any names 

associated with it. 

E_FAIL The method failed. 
20 The primary name of a data object is the server system name most likely to be 

used by a user to identify the data object. 
IHDXDataSource 

IHDXDataSource is implemented by all Hendrix data sources, 
interface IHDXDataSource : lUnknown 
25 { 

HRESULT ConnectO; 
HRESULT StartO; 
HRESULT StopO; 

HRESULT UninitializeO; 
30 HRESULT Ge1PersistenceHelper([out, retvalJIPersistStreamlnit **ppHelper); 

}; 



IHDXDataSource: : Coniieet 
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Requests a data source to establish a connection with its data provider. 

HRESULT ConnectO; 
Parameters: 
None. 

5 Return Code: 

S_OK The connection was successfully established and the data source 

can now be started. 

HDX_E_CONNECTFAILED The connection failed for some reason 
other than a failure of authorisation. 
10 HDX_EJSrOTAUTHORIZED The connection may have succeeded but 

the current user is not permitted to view the data provided by the data source. 

Returning HDX_E_NOTAUTHORIZED means that the loading of the display 
page for which the data source was to supply data will be aborted. This mechanism 
allows a data source to check the current user against criteria that is specified in the data 
15 sources persistent state in order to restrict data viewing to particular users. 
IHDXDataSource: rStart 

Signals the data source object model to begin delivering data and events. 

HRESULT StartO; 
Parameters: 
20 None. 

Return Code: 

S_OK . The method succeeded. 
E_FAIL The method failed. 
IHDXDataSource: :Stop 

25 Signals the data source object model to stop delivering data and events. 

HRESULT StopO; 
Parameters: 
None. 

Retum Code: 
30 S_OK The method succeeded. 

E_FAIL The method failed. 

A call to IHDXDataSource: :Start might follow the call to 
IHDXDataSource: :Stop. 
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IHDXDataSource: :Uninitialize 

Un-initialises the data source object model. 

HRESULT UiiinitializeO; 
Parameters: 
5 None. 

Return Code: 

S_OK The method succeeded. 

E_FAIL The method failed. 

The data source should release its references to the data source site object in 
10 IHDXDataSource: :Unimtialize. 

IHDXDataSource: : GetPersistenceHelper 

Retrieves the implementation of IPersistStreamlnit used to persist the state of 
the entire data source. 

HRESULT GetPersistenceHelper([out, retv^al]IPersistStreamInit **ppHelper); 
15 Parameters: 

ppHelper The implementation of IPersistStreamlnit that persists the entire 
data source. 

Return Code: 

S_OK The method succeeded. 

20 E_FAIL The method failed. 

IHDXDataSourceFactory 

IHDXDataSourceFactory is implemented by a Hendrix data source factory 

object. 

interface IHDXDataSourceFactory: lUnknown 
25 { 

HRESULT CreateDataSource([out] IHDXDataSource** ppDataSource); 

}; 



IHDXDataSourceFactory: :CreateDataSource 

30 Creates a new instance of the data source. 

HRESULT CreateDataSource([out] IHDXDataSource** ppDataSource); 
Parameters: 

PpDataSource Pointer to the newly created data source. 
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Retum Code: 

S_OK The method succeeded. 

E_FAIL The operation failed. 
IHDXDataSourceValidation 
5 IHDXDataSourceValidation is implemented by a Hendrix data source object 

model that supports validation. 

interface IHDXDataSourceValidation: lUnknown 
{ 

HRESULTVaMateO; 

10 HRESULT QueiyNeedsValidating([out,retval]VARIANT_BOOL* pbResult); 

}; 

IHDXDataSourceValidation: : Validate 

Requests a data source to attempt validation. 
15 HRESULT VahdateO; 

Parameters: 
None. 

Retum Code: 

S_OK The method succeeded. 

20 HDX_E_VALIDATEFAILED Validation failed. 

IHDXDataSourceValidation::QueryNeedsVaIidatiiig 

Queries the object model to determine if it needs to be validated. 

HRESULT QueryNeedsVahdating([out,retval]VAR[ANT_BOOL* pbResult); 

Parameters: 

25 pbResult TRUE if the data source requires vahdation, FALSE otherwise 

Retum Code: 

S_OK The method succeeded. 

IHDXDataTransfer 

IHDXDataTrausfer is implemented by Hendrix data source site object 
30 interface IHDXDataTransfer : lUnknown 

{ 

HRESULT FlushBufferO; 

HRESULT RegisterDataObject([in]long IID, 
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[m]IUnknown *pDataObjectUiik); 
HRESULT UiiregisterDataObject([m]long IID); 

}; 

5 IHDXDataTr ansf er : :Flush 

Requests that Hendrix data binding engine flush all data updates accvimulated 
since the last call to IHDXpataTransfer::Flush. 

HRESULT FlushO; 
Parameters: 
10 None. 

Return Code: 

S_OK The method succeeded. 

IHDXDataTransfer::RegisterDataObject 

Registers a data object with the Hendrix data binding engine. 
15 HRESULT RegisterDataObject([in]long HD, 

[in]rUnknown *pDataObjectUnk); 

Parameters: 

no The ID of the data object being registered. 

pDataObjectUnk A pointer to the lUnknoAvn interface on the data object 
being registered. 

Return Code: 

S_OK The method succeeded. 

E_FAIL The method failed. 
IHDXDataTransfer : rUnregisterDataOb j ect 

Un-registers a data object with the Hendrix data binding engine. 
HRESULT UnregisterDataObject([in]long IID; 
Parameters: 

IID The ID of the data object being unregistered. 
Return Code: 

S_OK The method succeeded. 

E_FAIL The method failed. 
IHDXError 



25 
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IHDXError is implemented by site objects to allow components to 
asynchronously generate error messages. 

interface IHDXError: lUnknown 

{ 

5 HRESULT RaiseError([in]BSTR bstrSource, 

[in]BSTR bstrDescription, 
[in]BSTR bstrHelpFile, 
[injimsigned long ixlHelpContext, 
[in]long ICode); 

10 HRESULT LogError([m]BSTR bstrSource, 

[injBSTR bstrDescription, 
[in]long ICode); 

}; 

15 IHDXError: iRaiseError 

Used to notify the firamework that an error has occiirred. 



HRESULT RaiseError([in]HDX_ERRORLEVEL level, 
[injBSTR bstrSource, 
20 [in]BSTR bstrDescription, 

[in]BSTR bstrHelpFile, 
[in]xmsigned long ulHelpContext, 
[injlong ICode); 



25 Parameters: 

level The severity of the error. See the HDX_ERRORLEVEL 

enumeration for details. 

bstrSource The source of the error, 

bstrDescription The description of the error. 
30 bstrHelpFile The help file for the error. 

ulHelpContext The help file context for the error. 

ICode The error code. 

Return Code: 
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S_OK The method succeeded. 

Errors raised with IHDXError::RaiseError axe logged in the Hendrix log file 
and propagated to the UI Framework, 
IHDXError : :LogError 
5 Used to write an error message to the log file. 



HRESULT LogError([in]HDX_ERRORLEVEL level, 
[in]BSTR bstrSource, 

[in]BSTR bstrDescription, 
10 [injlong ICode); 

Parameters: 

level The severity of the error. See the HDX_ERRORLEVEL 

enumeration for details. 
15 bstrSource The source of the error. 

bstrDescription The description of the error. 
ICode The error code. 

Return Code: 

S_OK The method succeeded. 

20 Errors raised with IHDXError: :LogError are logged in the Hendrix log file and 

are not propagated to the UI Framework. 
IHDXName 

IHDXName is implemented by data source objects, 
interface IHDXName: IDispatch 
25 { 

[propget, id(0)]HRESULT Type([out, retvalJBSTR *pbstrType); 
[propget, id(l)]HRESULT Name([out, retval]BSTR *pbstrName); 
[propput, id(l)]HRESULT Name([in]BSTR bstrName); 
[propget, id(2)]HRESTJLT FulIName([out, retval]BSTR *pbstrFullNaine); 
30 }; 



IHDXName: :get_Type 

Returns the type of a named server system data item. 
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[propget, id(0)]HRESULT Type([out, retvalJBSTR *pbstrType); 
Parameters: 

pbstrType The type of tlie named server system data item. 
Retum Code: 
5 S_OK The method succeeded. 

E_FAIL The method failed. 
IHDXName: :get_Name 
Returns the name of a server system data item, 
[propget, id(l)]HRESULT Name([out, retval]BSTR *pbstrName); 
10 Parameters: 

pbstrName The name of a server system data item. 
Retum Code: 

S_OK The method succeeded. 

E_FAIL The method failed. 
15 IHDXName: :put_Name 

Sets the name of a server system data item. 

[propput, id(l)]HRESULT Name([in]BSTR bstrName); 

Parameters: 

bstrName The name of a server system data item. 
20 Retum Code: 

S_OK The method succeeded. 

E_FAIL The method failed. 

IHDXName : : get_FullName 

Returns the full name of a server system data item. 
25 [propget, id(2)]HRESULT FullName([out, retval]BSTR *pbstrName); 

Parameters: 

pbstrName The full name of a server system data item. 
Retum Code: 

S_OK The method succeeded. 

30 E_FAIL The method failed. 

IHDXSecurity 

IHDXSecurity is implemented by the Hendrix data source manager, 
interface IHDXSecurity: lUnknown 
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{ 

HRESULT Advise([in]IHDXSecurityNotify *pNotifySiiik, 

[out, retvaljlong *plCookie); 
HRESULT Unadvise([in]long ICookie); 

5 }; 

IHDXSecurity : : Advise 

Establishes an advisoiy connection with the security service. 

HRESULT Advise([in]IHDXSecurityNotify *pNotifySink, 
10 [out]long *plCookie); 

Parameters: 

pNotifySink A pointer to the IHDXSecurityNotify interface that is to 

receive security notifications. 
15 plCookie A cookie identifying the advisory connection. 

Return Code: 

S_OK The method succeeded, 

E_FAIL The method failed. 

The caller of IHDXSecurity: :AdviseO should remember the returned cookie so 
20 that it can revoke the connection at a later time. 
IHDXSecurity: zUnadvise 

Revokes an advisory connection with the security service. 

HRESULT Unadvise([in]long ICookie); 
Parameters: 

25 ICookie A cookie identifying the advisory connection. 

Return Code: 

S_OK The method succeeded, 

E_FAIL The method failed. 
IHDXSecurityNotify 

30 IHDXSecurityNotify is implemented by a Hendrix data source component that 

needs to know about changes to the security access token, 
interface IHDXSecurityNotify: lUixkaown 
{ 
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HRESULT OnCredentialChangeO; 

}; 



IHDXS ecurityNotify : : OnCr edentialChange 

5 Notifies the implementation of changes to the user's security credentials. 

HRESULT OnCredentialChangeO; 
Parameters: 
None. 

Return Code: 
1 0 S_OK The method succeeded. 

User credentials consist of the user name and password. These credentials are 
accessible via the Usemame and Password ambient properties. 

There follows some details on the Hendrix data source standard properties. 

SimulatedData 
15 Type 

VARIANT^BOOL 
Description 

Indicates whether real or simulated data is required from the data source. If the 
value is TRUE then the simulated data is required. 
20 A data source may respond to a value of TRUE by not generating any data at 

all, if simulated data is too difficult to generate, 
QualityOfService 
Type 

HDX^QUALITYOFSERVICE 
25 Description 

Indicates the desired quality of service to be provided by the data source. 
Possible values are HDX_QUALITYOFSERVICE_LOW, 

HDX_QUALITYOFSERVICE_MEDTUM and HDX_QUALITYOFSERVICE_HIGH. 

It is up to the data source implementation to determine if it is possible to 
30 provide different levels of quality of service. Refer to the 

HDX^QUALITYOFSERVICE enumeration for further details. 

The following is a description of the Hendrix data source ambient properties. 

DataTransfer 
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Type 

IHDXTransfer * 
Description 

Contains a poiater to the IHDXTransfer interface. 

5 Error 

Type 

IHDXError * 
Descaiption 

Contains a poiater to the IHDXError interface. 
10 Password 
Type 

BSTR 
Description 

Contains the current user's usemame. 
15 Security 

Type 

IHDXSecurity * 
Description 

Contains a pointer to the IHDXSecurity interface. 
20 Usemame 
Type 

BSTR 
Description 

Contains the current user's usemame. 
25 The following is a description of the Hendiix data source enumerations. 

HDX_DATASOURCE_ERROR_CODES 
enum { 

HDX_E_NOPARENT = -2 1 4722 1 504, 

HDX_E_NONAME =-2147221503, 
30 HDX_E_INVALIDTYPE =-2147221502, 

HDX_E_NOTCONTAINER =-2147221501, 
HDX_E_CONNECTFAILED =-2147221499, 
HDX_E_NOTAUTHORIZED =-2147221498, 
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HDX^E^VALIDATEFAILED = -2147221497 

} HDX_^DATASOURCE_ERROR_CODES; 



Description 

5 Enumerates the Hendrix specific error codes returned by Hendrix interface 

methods. 

HDX_ERRORLEVEL 

enum { 

HDX_ERRORLEVEL__INFO =0, 
10 HDX_ERRORLEVEL_WARNING -1, 

HDX_ERRORLEVEL_ERROR =2 
} HDX^ERRORLEVEL; 

Description 

15 Enumerates the severity levels for messages being written to the data source 

managers message logging service. 

HDX^QUALITYOFSERVICE 
enum { 



20 HDX_QUALITYOFSERVICE_LOW =0, 

HDX_QUALITYOFSERVICE_MEDIUM = 1, 

HDX„QUALITYOFSERVICE_fflGH = 2 
} HDX^QUALITYOFSERVICE; 



25 Description 

Enumerates the possible levels of quality of service that a data source may be 
asked to provide. 

For the benefit of the addressee, the description is now directed toward an. 
overview of the runtime used in the preferred embodiments. Firstly, this will require 
30 some explanation as to what constitutes a Hendrix runtime. Hendrix is designed 
around providing users with two ways to view and control plant information: the 
operator environment, designed primarily for security and rehability, and the web 
browser environment, where universal, flexible, secure data access is the prime 
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concem. Development groups wishing to base their user interfaces on the Hendrix 
architecture must develop components for both of these environments; the 
combination of which is referred to jointly as a Hendrix runtime. 

In the operational environment, the runtime centres around the concept of the 
5 operator framework (sometimes referred to as the operator runtime framework). 

In the web browser environment, the runtime centres around Hendrix displays 
being rendered in Microsoft's Internet Explorer web browser, with the assistance of 
nimierous Hendrix-specific components which facilitate the connection to live process 
data. Some of these components are generic, and form part of the Hendrix toolkit that 
10 has been developed by the Honeywell Software Center. Others, however, are product- 
specific and need to be implemented by each development group individually. 

The Hendrix runtime, in both environments, consists of a number of distinct 
components. Figure 33 and Figure 34 illustrate - for both the operator framework and 
the browser environment — those components most closely related to the user interface 
15 itself Data-related components, such as Hendrix data sources manipulated by the Data 
Source Manager, are dealt with elsewhere in the Hendrix documentation set. 

Note that some of the components are supplied by Microsoft as part of the 
operating system, others components are part of the Hendrix toolkit, while other 
components must be developed by each development group implementing a Hendrix 
20 runtime. 

The responsibilities of the various components shown in Figure 33 and Figure 
34 are as follows: 

Data Source Manager (DSM) 

The Data Source Manager is responsible for managing data sources and 
25 connections, and for transferring data from data sources to elements on an HTML 
page via the page connector. 
Framework 

The operator framework corresponds to the application window (or windows) 
interface artifacts such as toolbars and menus, which are tailored for the operational 
30 environment. It also provides desktop management fixnctionaUty, where appropriate, 
and participates m the lifetime management of the data source manager. 
Browser Helper Object (BHO) 
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The browser helper object provides additional application-level fimctionality to 
the browser, and fulfils the responsibilities that are otherwise handled by the fi-amework 
in the operational environment. It co-operates in the lifetime management of the data 
source manager, for example, closing it when Intemet Explorer itself is closed. 
5 Shdocvw.dll 

The shdocvw.dll provides the functionality of the web browser control, which is 
used by both the firamework and Intemet Explorer for HTML rendering and navigation. 
This DLL uses MSHTML for the rendering of HTML content. If a jframework requires 
lower-level control over the rendering process it optionally hosts MSHTML directly. 
10 Page Connector 

The display page connector is placed on every Hendrix display file, and is 
responsible for managing the delivery of data to objects on a page. It is part of the 
Hendrix toolkit. 

Urlmon.dIl 

15 Urlmon.dIl is a system component responsible for assisting in the transfer of 

remote data (such as HTML via HTTP) to applications which require it. The web 
browser control uses urlmon.dll to download HTML files. 
Asynchronous Pluggable Protocol (APP) 

Sitting on the other side of urlmon.dll is the Hendrix Asynchronous Pluggable 
20 Protocol. This protocol is responsible for handling page call-up security, path 
substitution to enable easy page call-up and to assist in intemationalisation, and 
participating in the instantiation of the data source manager. Its responsibilities are 
discussed in detail below. 

Running Object Table 
25 The Running Object Table (ROT) is used to assist in the connection of data 

source managers to the correct page connector in the runtime. This is to facilitate the 
ability to maintain coimnunication with the data source manager across page changes. 
It is envisaged that later revisions of the architecture will require a custom object to 
fixlfiU this purpose, as a three-tier architecture may require greater fimctionality than 
30 that provided by the ROT. 

The preferred embodiments of the invention deal with implementing Hendrix- 
compliant versions of the framework and the browser helper object. 
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The Asynchronous Pluggable Protocol (henceforth referred to as the APP) is 
part of the Hendrix tooUdt. A description of APPs in general can be found in the 
MSDN Library (under "Asynchronous Pluggable Protocols Overview"). In essence, 
these are components responsible for downloading information to be interpreted by 
5 the Internet Explorer web browser, the web browser control, or other internet-enabled 
applications. Protocols are represented textually as the first part of a URL up to the 
colon, and are provided by the system for all major protocols: 

• ftp (e.g. fip://flp.microsoft.com) 

• file (e.g. file:c:\debug.txt) 

10 • mailto (e.g. mailto:head.honcho@honeywell.com) 

• http (e.g. http://www.microsofl.com) 

In the Hendrix architecture the APP implements the "page" protocol. Its main 
responsibilities revolve around page callup security, and path substitution, as follows. 

All URLs to Hendrix pages (as created in the Hendrix builder) are of the form 
15 page://pagename (or page://pagename.htm). To browse directly to a Hendrix page in 
Internet Explorer, typing a URL of this form is sufficient. (Normal HTTP addresses 
are allowed well, but the architecture will redirect these pages so that they use the 
page protocol). 

When a page URL is activated, the APP is invoked. Its first responsibiUty is to 
20 turn this URL into a fiilly-quaUfied URL. It does this by querying the framework for 
the current display search path, and then locating the file within that search path. For 
example, if the current search path is c:\Honeywell\displays\English, the URL 
page://displayl.htm will resolve to c:\Honeywell\displays\English\displayl.htm. 

This path substitution mechanism is intended to provide the fi^amework with 
25 control over which displays are shown. The ciurent path depends on the chosen 
operator language, the current department being viewed, or other factors - it is 
completely up to the framework each time a page is called up. 

APPs are inherently stateless, and must query the framework for the search 
path each time a page is accessed. It obtains access to the firamework through the 
30 ROT, as described later in this document. 

Once the URL is fully resolved, the APP authenticates the user to ensure the 
current operator has sufficient security privileges to call up the display. It does this by 
downloading (fi-om the intemet or local file system) the relevant file and associated 
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data binding definitions, and queries the DSM for permission to open the file. The 

APP obtains access to the DSM through the ROT. 

The DSM in turn attempts to activate the relevant data sources for the file. If 

any of these fail due to insufficient security privileges, tlie DSM indicates to the APP 
5 that the operator is not allowed to view the file. The APP then passes no information to 

the browser, leaving the operator on the current page. If successfiil, however, the APP 

passes the HTML to the browser, and the page is called up normally. 

The interfaces which allow the firamework to co-operate with the APP in this 

way are described below. 
10 This part of the specification discusses the main implementation strategies for 

a Hendrix fi-amework, and then details the responsibilities of the firamework, as far as 

the Hendrix architecture is concerned. This fimctionality is divided into two sections: 

basic and advanced. Basic fimctionality covers hosting the web browser control, 

instantiation of the Data Source Manager, and participation in the call up of Hendrix 
15 displays. Advanced functionality covers all other issues conceming the framework, 

such as participation in page callup security, popup windows, path substitution, error 

handling, security, and intemationalisation. 

In essence, a Hendrix framework is any application capable of hosting 

Microsoft's Web Browser Control (shdocvw.dll), which in turn plays host to the 
20 MSHTML rendering engine. The implication of this is that any technology is 

conceivably useable to implement a Hendrix framework: Visual Basic, Microsoft 

Foimdation Classes, the Active Template Library, etc. 

For this reason, this detailed description does not concem itself with any one 

particular implementation strategy, but instead focuses on what fimctionality these 
25 frameworks must implement if they are to participate in the Hendrix architecture. In 

some cases the document does present sample C++ ATL and/or MFC code, but this is 

for illustrative purposes only: it does not imply that this is the only way this 

fimctionality is available to be implemented. 

The MSDN Library and MSDN Online provide several excellent samples 
30 illustrating how to host the web browser control, in various technologies. These are 

listed below and the content thereof is incorporated herein by way of cross-reference. 

All samples listed (apart from MFCIE, which is in the MSDN Library) can be found 
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as part of the download of IE5 headers and Ubraries from MSDN Online, at 
http://nisdn.microsoftxom/downloads/samples/mternet/setup/entry 
MFC 

• MFCIE sample, illustrating the use of the CHtmlView class. 

5 • The MFCIEEvtSpy sample, which illustrates how to sink Internet Explorer events. 

• The article "Creating a web browser-style application" in the MSDN Library 

ATL 

• The AtlBrowser sample 

Visual Basic 

10 • The VB WebBrowser sample, illustratmg a full-functioned VB web browser. 

• The WBCustomizer sample, illustrating how to implement the IDocHostUIHandler 
interface from Visual Basic. 

• The DrillVB sample, which demonstrates how to traverse the DOM from an 
external application. 

1 5 Framework Implementation 

Upon application startup, the framework performs the following tasks: 

1 . Start the Data Source Manager 

2. Register a pointer to the rimning DSM in the Running Obj ect Table. This is so that 
other Hendrix components (specifically, the Page Connector and the APP) are able 

20 to obtain access to the correct DSM, when required. 

3. Register a pointer to the framework itself in the ROT. This allows the APP to 

access the correct framework when it requests path information. 
These actions are discussed in greater detail below. 
The following IDL is usually sufficient to indicate how the DSM is to be 
25 activated. 

[ 

uuid(9C657542-64B8"llD3-80D0-00C04F6847A2), 
helpstring("HDXDataSourceManager Class") 

] 

30 coclass HDXDataSourceManager 

{ 

[default] interface IHDXDataSourceManager; 

}; 
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Upon startup the framework simply needs to activate and bind to this object. In 
ATL this may consist of little more than the following line: 

hr = m_spDSM.CoCreateInstance( CLSID_HDXDataSourceManager ); 
5 As already described, the ROT is used to store references to a running instance 

of the DSM for each instance of the framework (in some systems multiple frameworks 
may be running simultaneously on a single node). 

This system reUes on the fact that in the Hendrix architecture there is a one-to- 
one relationship between instances of the DSM and instances of the framework. Each 
10 instance of the framework has a unique process ID, which is what is used to identify 
itselfintheROT. 

The DSM is registered in the ROT by means of an item moniker. The name of 
this item moniker takes the following format: 
!HDX:DSM:pid=xxxx 
15 where xxxx is the process ID of the framework in question (e.g. 1234). 

The following code sample illustrates how registration may be performed in 

ATL. 

CComBSTR bstrDelim(" ! "); 
CComBSTR bstrItem("HDX:DSM:pid-1234"); 
20 CConiPtr<IMoniker> spMoniker; 

// create a moniker to the DSM 

hr = CreateItemMoniker(bstrDeUm, bstrltem, &spMoniker); 



25 // now register it in the ROT 

CConiPtr<IRunningObjectTable> spROT; 
GetRunningObjectTable(NULL, &spROT); 
hr = spROT->Register(NULL, m_pDSM, spMoniker, 
&m_dwDSMCookie); 

30 

The framework is registered in a similar manner to the DSM. In the case of the 
framework, the format of the item moniker is: 
!HDX:RT:pid==xxxx 
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Note that RT (runtime) is used as this moniker is also used by the Browser 
Helper Object. 

The following code thus illustrates registration of the framework in ATL: 
// pUnkThis is assumed to be an lUnknown * to the framework itself. 
5 // This interface must be able to be queried successftiUy for IHDXSearchPath, 

// as described in section 3.3, "Advanced Framework Functionality". 



CComBSTR bstrDelim(" ! "); 
CComBSTR bstrItem("HDX:RT:pid=1234"); 
10 CConiPtr<IMoniker> spMoniker; 

// create a moniker to the DSM 

hr = CreateItemMoniker(bstrDelim, bstrltem, &spMoniker); 



15 // now register it in the ROT 

CConiPtr<IRunningObjectTable> spROT; 
GetRunningObjectTable(NULL, &spROT); 

hr = spROT->Register(NULL, pUnkThis, spMoniker, &m_dwRTCookie); 

20 Context menus are, in general, specific to an individual application. If a 

framework wishes to implement context menus other than those provided by Internet 
Explorer, it needs to implement the IDocHostUIHandler interface. The samples 
described elsewhere in this specification all demonstrate how to achieve this in 
various programming environments. It should be noted that it is much easier to do 

25 this in C++ than VB. 

Upon application shutdown, the framework removes any references to the DSM 
or to itself stored in the ROT. Following on from the previous examples, it does this 
with the following calls: 

hr spROT->Revoke(m_dwDSMCookie); 

30 hr = spROT->Revoke(m_dwRTCookie); 

The framework then calls ReleaseQ on the Data Source Manager to cause it to 
unload itself from memory. After this the framework terminates. 
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Some detail is provided below to explain how a Hendrix framework behaves to 
support the more advanced functionality provided by the Hendrix architecture. Each of 
these is dealt with separately. It will be appreciated by those skilled in the art, given the 
teaching herein, that modifications and alternatives are available. 
5 Security 

The framework participates in the acquisition of security credentials from the 
user, which are then passed to the DSM and on to the respective data sources. 

Display Path Management and Internationalisation 

As mentioned earlier in this description, the framework is responsible for 
10 determining which sets of displays are presented to a user, through the use of display 
search paths. 

Search paths are implemented in the Hendrix architecture through the use of the 
IHDXSearchPath interface. The APP queries the lUnknown interface it retrieves from 
the ROT for this interface. The framework implements this interface if it is to rely on 
1 5 partially-formed URLs for page callup. 

Path substitution forms the core of a number of mechanisms for Honeywell 
products. Two examples are intemationalisation and the notion of departments in OCS. 

For intemationaUsation, path substitution provides a mechanism to dynamically 
switch between different sets of displays, each built for different languages. For 
20 example, a framework might start viewing English displays only, stored in 

c:\Honeywell\displays\English. Upon page callup, the APP requests this path from the 
framework, and resolves this to the relevant English display accordingly. 

Upon change of operator, however, the framework switches language as 
appropriate. If a Finnish operator were to log in, the framework switches the search 
25 path to c:\H0ne3rwell\displays\Finnish, and the APP thenceforth calls up the Finnish 
displays. 

In OCS, an operator logs in to various departments. The current department will 
determine which displays the operator will view. Underljdng the OCS system, displays 
from differing departments are each stored in different directories. The OCS Hendrix 
30 framework thus dictates which displays are called up according to department, by 
passing the relevant display path to the APP when requested. 

Frameworks have the capability of participating in the popup window 
fimctionality provided as part of the Hendrix tooUdt. This participation consists of: 
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1 . The ability to specify how many popup windows are to be active at any one time; 

2. The ability to specify if popup windows themselves are available to activate other 
popup windows; 

3. The ability to store and retrieve popup configurations 

5 Developers of Hendrix runtimes are provided with the flexibility of choice, as 

this functionality is optional; and only needs to implemented it if it is intended to utilise 
popup window functionality in the framework being developed. 

The framework specifies how many popup windows are able to be loaded at any 
one time by exposing a Hendrix-specific property, maxPopups, to objects on the page 
10 through IDocHostUIHandler. This interface allows a hosting appUcation to extend the 
DOM via the window.extemal property. Thus, if the framework sets 
window.extemal.maxPopups to two, at most two popup windows will be displayed at 
any one time. 

Similarly, the framework govems whether popup windows are to activate other 
15 popup windows by exposing a custom property, window.extemal.popupFromPopups, 
which it sets either to tme or false accordingly. 

The popup functionality of the Hendrix architecture possesses the ability to store 
and retrieve configurations of popup windows. This is exposed by an object on every 
Hendrix display named "WindowManager". An abridged version of the DDL for the 
20 WindowManager is shown below. 

[ 

object, 

uuid(034DB16D-AE01-llD3-BE8D-00C04F7915FE), 
dual, 

25 helpstring("IPopupFactory Literface")j 

pointer_default(unique) 

] 

interface IPopupFactory : IDispatch 
{ 

30 HRESULT CreatePopupWindow([in] BSTR IpPageFile, [in] int iXpos, [in] int 

iYpos, 

[in] int iWidth, [in] int iHeight); 
HEIESULT SavePopupConfig([in] BSTRbstrName); 
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HRESULT LoadPopupConfig([in] BSTR bstrName); 
HRESULT CloseAllWindowsO; 

}; 

5 In most cases the creation of popup windows is performed by objects on the 

page itself, and does not require the assistance of the framework. (If the framework 
does wish to create popup windows, it still does so by calling the CreatePopup Window 
method of the WmdowManager object embedded in the current page.) 

In some embodiments, the Hendrix framework requires the ability to close all 
10 popup windows. This fixnctionaUty is often presented to the operator as a single toolbar 
button in the framework. It is available through the CloseAllWindows method. 

Some Hendrix frameworks also store current configurations of popup windows 
for later retrieval. This is achieved via the SavePopupConfig and LoadPopupConfig 
methods. These methods accept a string which uniquely identifies the configuration 
15 name. In most cases this string does little more than identify the current operator. 

The Hendrix architecture, in some embodiments, incorporates an error handhng 
capability. Some framework support is required to enable this ftinctionality. 

The discussion of framework implementation up until this point incorporates 
only the abiUty to instantiate the Hendrix architecture, and call up Hendrix displays. For 
20 a large number of framework implementations, this fimctionality wiU be sufficient. 
This is especially the case for GUS-style frameworks, where aU fimctionality is placed 
in the displays for a system, with the framework a simple frame window (or windows) 
around the web browser control. 

For many other frameworks, however, greater fimctionality is required. In 
25 particular, the framework needs to be able to issue commands (triggered by toolbar 
buttons or menu items, for example) to the relevant data sources. 

This scenario corresponds to binding an event fired by the framework to a 
method on tlae data source, which is fimctionality provided by the Hendrix binding 
engine for objects on an HTML page. The Hendrix architecture allows frameworks to 
30 participate in this fimctionality as well, firing events through the binding engine to data 
soxxrces, as shown in Figure 35. 

There are two ways Hendrix development groups constructs ttieir frameworks to 
participate in this type of data/event binding: 
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1 . Construct the framework user interface primarily from HTML. This is achieved in a 
number of ways: frames in an HTML appUcation, or by multiple instances of the 
web browser control embedded in a Win32 application. PlantScape's first 
implementation of a Hendrix framework, for example, implements the status zone 

5 and alarm zone completely in HTML. Note that this does not necessarily require 
extensive HTML scripting, as these areas of HTML consist of ActiveX controls to 
provide arbitrarily complex ftuictionality. In this scenario, the HTML portions of - 
the framework conform to the Hendrix file format, including a definition for binding 
data and events from an appropriate data source. The page connector on each page 
10 then simply connects to the data source manager and binds events as appropriate. 

2. Construct the framework user interface using the Win32 API. In this case, the 
framework provides an object model which participates in the Hendrix binding 
mechanism. 

Some additional fimctionality that is available for use in the Hendrix framework 
15 is Safe View conformance. Framework implementations are fially SafeView-compliant 
to facilitate frill convergence of user interfaces between systems. 

Browser helper objects are covered in detail in the MSDN Library. In essence a 
BHO is a COM object that is loaded by Intemet Explorer at startup, and which can 
connect to Document Object Model events fired by the browser and act on ftiem 
20 accordingly by manipulating the DOM. 

As an instance of the BHO gets instantiated for each instance of Intemet Explorer, 
it is not desirable for the BHO to start the DSM as soon as it loads. Instead, it hooks into 
Intemet Explorer events to detect when a Hendrix page (distinguished by the use of the 
page protocol) is first loaded. The BeginNavigate2 event is most appropriate for this 
25 purpose. 

Beyond this point, the responsibilities of the BHO are identical to those of the 
framework itself, and for the most part are covered earlier in this specification. It is 
responsible for registi-ation and im-registration of objects in the ROT, for the 
management of display paths, and so on. It is up to each individual development group 
30 how their own BHO should present configuration of this information (path setup, for 
example, or the abihty to switch languages dynamically) to the user. 

In the area of context menus, the operation of the BHO is sUghtly different from 
that of the framework. This is because the BHO is not responsible for hosting the web 
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browser control, but is merely a COM object attached to Jntemet Explorer. The 
IDocHostUIHandler interface is designed primarily for web browser implementers, not 
for Intemet Explorer itself. 

It is possible, however, for an extemal object to override the user interface 
5 (menus, context menus and toolbar) functionality of Intemet Explorer, through the use 
of the ICustomDoc interface. The ICustomDoc interface is described in the MSDN 
Library. It allows an object to set the XJI handler for an instance of MSHTML, and is 
used by the BHO as follows: 

if (IsPageProtocolQ) // only do this for Hendrix pages 
10 { 

CComPtr<IHTMLDocument2> spDoc; 

CComPtr<ICustomDoc> spICD; 

// Set ourselves up as the UI handler for IE 

m spWebBrowser2->get_Document((IDispatch * *)&spDoc); 
15 spDoc->QueryInterface(IID_ICustomDoc, (void **)&spICD); 

if(spICD) 

spICD->SetUIHandler(this); 

} 



20 From this point the functionality is no different from any other application 

wishing to host the web browser control. 

Advanced functionality for the BHO is largely identical to that provided by the 
framework, and is summarised below. 

The BHO assists in the security and authentication mechanisms of the Hendrix 
25 architecture just as the framework does. Unlike the framework, however, the BHO has 
no inherent user interface of its own. It is up to the implementer of the BHO as to what 
user interface is provided to allow the operator to log on in the web browser 
environment. 

The BHO must implement IHDXSearchPath to provide the APP with a vahd 
30 search path for displays. It is up to the implementer of the BHO as to what user 
interface is provided to allow the user to configure these search paths. 
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The BHO is able to control the behavioiir of popup windows by extending the 
object model of the browser. Note that the mechanism a BHO uses to extend this object 
model is the same as it uses to override context menus, as described above. 

Like the framework, the BHO is responsible for retrieving system level error 
5 information, and either logging these errors or (where appropriate) presenting them to 
the user. 

As the BHO possesses no user interface of its own, it is largely unable to execute 
system-level actions. In the web browser environment, operational functionality is 
largely restricted to the display shown. 
10 Hendrix displays include of a number of different user-interface components, the 

most common being HTML elements, VML objects, behaviours, embedded displays, 
and ActiveX controls. Before discussiag the requirements of ActiveX controls in the 
Hendrix architecture, it is worthwhile examining briefly when it is appropriate to use 
those controls. 

15 Performance analysis of the MSHTML rendering engine has demonstrated that 

one performance bottleneck is in the callup of ActiveX controls. This is recognized by 
Microsoft, and is not likely to change m the upcoming releases of Intemet Explorer. 
MSHTML is capable of meeting the Hendrix performance targets, but displays 
containing controls will remain slower to call up than displays containing similar 

20 functionality implemented via other means, such as a combination of HTML, 
behaviours, and script. 

In general, therefore, controls are most appropriate for use in Hendrix when: 

• It is expected that few such controls will ever exist on a single page. 

• The control contains complex user interface interaction that would be difficult to 
25 implement using DHTML. 

• The call-up performance of the control does not matter. 

• The control is large enough that it is unlikely that there will be much other content 
on the page. 

• The control implements functionahty that may need to be reused in other containers, 
30 such as in Visual Basic applications. 

• The control already exists. 

This should not imply that controls are not central to the Hendrix display page 
architecture: world-class support of ActiveX controls is one of the strengths of Hendrix, 
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Where a control is likely to be used several hundred times on a display page, however, 
that same functionality is best implemented via other mechanisms. In other 
embodiments, the functionality provided by a single large control is implemented just as 
easily by a combination of DHTML and other, smaller controls. This latter strategy has 
5 the advaatage that these types of composite controls are able to be built and customized 
completely using the Hendrix builder or other DHTML authoring tools. 

One of the main requirements of the architecture of the preferred embodiments 
is its support for third-party controls. The requirements of a control for Hendrix 
compliance are quite modest, and in many cases consist of recommendations rather than 

1.0 rules that must be obeyed. As a result, most third-party controls integrate smoothly into 
the Hendrix architecture. 

The following description discusses the differing technologies available for the 
implementation of Hendrix controls: primarily the Active Template Library (ATL), 
Microsoft Foundation Classes (MFC), and Microsoft Visual Basic (VB). 

15 The Hendrix architecture is not prescriptive when it comes to which of these 

technologies should be used to implement controls. As long as controls conform to the 
requirements enumerated in this document, they are able to be built with any of the 
above technologies (or even others, such as Java). However, it is worthwhile discussing 
the various features of the major technologies listed above, and considering when each 

20 is appropriate to be used. 

Most windows developers are already familiar with and probably use the 
Microsoft Foxmdation Classes (MFC). The purpose of MFC is to speed the. 
development of large, Windows-based applications, which generally have significant 
GUI components. MFC does support the creation of controls. However, the support for 

25 COM in MFC was added long after its initial implementation, and as a result its 

implementation is somewhat convoluted, and restricted in what it can do. In particular: 

• MFC does not easily support dual interfaces. 

• MFC controls require the MFC runtime libraries. This has an impact on size and 
performance, and also on the potential to deploy the controls via the web. 

30 Like MFC, Visual Basic provides a convenient starting point for building simple 

controls, as it hides most of Ifae complexity associated with building the control. In 
addition, the later versions of Visual Basic are far more oriented to control creation than 
MFC, and include support for windowless controls and dual interfaces. In general. 
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Visiial Basic is even simpler to use than MFC. It still suffers from some restrictions, in 
particular: 

• Controls implemented in Visual Basic still require the VB ruatime libraries. As 
with MFC, this produces heavier controls that are more difficult to distribute via the 

5 web. 

• The performance of Visual Basic code is generally slower than code implemented in 
C++. 

• The fact that VB hides most of the implementation details is sometimes a drawback, 
particularly when creating controls that need to implement non-standard 

10 functionality. The framework provides ease of use at the expense of flexibility. 

The Active Template Library (ATL) was built by Microsoft from the ground up 
as a development platform for developing the most efficient, streamlined, high- 
performance controls as possible. ATL includes a number of features which make it 
very useful for control creation, including: 

15 • Wizards used to create COM components and controls. 

• Template classes for COM fundamentals such as class factories and self- 
registration. 

• Support for DDL. 

• Complete implementation flexibiUty, including support for windowless controls, 
20 multiple threading models and dual interfaces. 

ATL does, however, have its drawbacks, most notably that it is initially more 
difficult to use than either VB or MFC, particularly for developers familiar with either 
of those products. It also requires a sound knowledge of COM. 

As a result of the features discussed above, the following general 
25 recommendations are provided as to which technology is used to implement controls: 

• Hendrix controls are, ideally, as small and lightweight as possible. The ability of 
ATL to create controls without dependencies on large runtime libraries, which are 
optimised for drawing performance, and as flexible as possible, means that in many 
cases ATL will be the most appropriate tool for control creation. 

30 • It is recognized that in many simple controls, the performance of VB-generated 

controls approach that of ATL. In addition, the performance limitations of controls 
in the Hendrix architecture will ultimately rest with the MSHTML rendering engine, 
rather than the controls themselves. Given Visual Basic's ease of use, in many 
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cases it offers itself as a viable alternative to ATL, particularly when large nxmibers 
of controls are required in a short time. The dependency of Visual Basic controls on 
the VB runtime libraries, however, still impose restrictions on those controls, so 
ATL is still advised. 

5 As previously mentioned, however, the arcliitecture is not proscriptive when it 

comes to these recommendations, and the final choice is up to the individual developer. 

The Hendrix architecture imposes very few constraints on controls as far as what 
methods, properties and events they must support. As far as the architecture is 
concemed, controls and behaviours are generally "dumb", and whichever properties 
10 they implement must be suppUed with data via the standard Hendrix data deUveiy 

mechanisms. This has impUcations for the builder, in how to connect data to the various 
control properties, but these are issues for the builder, not the control. 

In addition, much of the Hendrix-specific functionality required by controls and 
behaviours (data deUvery, access to the data references data source object model which 
15 drives the control, etc.) is also required by data-bound HTML elements more generally. 
This functionality will not be implemented by the control/behaviour itself, but by 
custom binary behaviours that are applied to the control at authoring time by the builder. 

There are, however, a number of things that should be considered when 
implementing a control or behaviour intended for the Hendrix environment. These fall 
20 into two categories: those that must be supported by all Hendrix-compliant controls and 
behaviours, and those which are more recommendations as to how good Hendrix 
controls and behaviours should behave. 

The following aspects are required by all Hendrix-compliant controls and 
behaviours: 
25 Quality Indication 

A control/behaviour has any number of properties that are supplied with data by 
the binding engine. For each of these properties, the control/behaviour requires some 
way of indicating quality. One way to implement this functionality is by implementing 
each property as an object, with its own properties of value and quality. The value is a 
30 default property of this object, so that the following calls are identical: 
control.propertyl = 100 
control.property Lvalue =100 
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Quality indication for the property is then accessed via controLpropertyl .quality. 
The control sample demonstrates how this quality mechanism is implemented in an 
ActiveX control. This method is ideal for those controls/behaviom*s that have more than 
one bound value where each one requires a separate quality indication. This situation 
5 mainly arises with more complex controls^ehaviours, one example being a trend 
control. 

Altematively, if your control/behaviour simply requires a single quality 
indication, and has one or more bound value properties, then a single quality property is 
exposed on the control/behaviour. It is then a simple process to bmd this quality 
10 property to the equivalent quality property on the associated data source. 

The major imphcation of this scheme is that the convergence team had to decide 
on a canonical form for this quaUty value. Without a converged concept of quaUty, 
controls/behaviours designed for one data source component will not work with other 
data source components. 
15 Once a property's quality value is set, it is up to the control/behaviour as to how 

it represents that quality indication visually. This, again, is another potential area for 
convergence, with the potential for a standardized look and feel for controls. 

Alarm Indication 

Controls/behaviours which require alarm information obtain this through 
20 separate alarm properties. Generally this property shall be named "alarm", though some 
controls/behaviours require a number of alarm inputs so this name is not mandatory. 
Controls/behaviours interpret alarm parameter values according to the Hendrix 
canonical form for alarm information, which is described below. 

Note that in some embodiments the alarm consolidation is performed either in 
25 the data source or sources, or in transformations in the binding engine prior to being 
applied to the control. This allows for arbitrarily complex manipulation of alarm data, 
and even the provision of alarm data from separate data sources, such as the Alarm List 
Manager. 

Build-Time Requirements 
30 Hendrix controls/behaviours exhibit specific build-time behaviour, so that they 

are able to be configured by the unified Hendrix builder. 
Property Binding 
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Hendrix controls/behaviours implement bindable properties, and support 
pessimistic binding. This implies that the control/behaviour supports the 
IPropertyNotifySink interface, and that the properties on the control/behaviour are 
marked as both bindable and requestedit in the IDL file for the control/behaviour. 
5 Controls/behaviours built with ATL will fire the OnRequestEdit event when a property 
changes, as part of the standard ATL implementations. Controls/behaviours bmlt in 
other environments will need to ensure that this event is fired as appropriate. 

Persistence 

Controls/behaviours must persist their configuration in a human-readable format 
10 in conformance with the standard for controls/behaviours in HTML files. In order to 
implement this fimctionality the control/behaviour must implement the 
IPersistPropertyBag interface. 
Scripting 

Hendrix-compliant controls/behaviours are able to be scripted in the standard 
15 web browser environment. To mark an object safe for initialisation and scripting, the 
control/behaviour implements the lObjectSafety interface. 
Zooming 

Hendrix-compliant controls/behaviours are able to support zooming. 
The following aspects are recommendations as to how Hendrix 
20 controls/behaviours should behave. These recommendations are often to do with the style 
of a control/behaviour, how it wiU appear to a user, and how native it wiU feel in the 
Hendrix environment. If they are not implemented, the control/behaviour wiU still 
fimction in the Hendrix environment, but not as well as controls/behaviours which do 
follow these recommendations. 
25 Data Access 

Hendrix controls/behaviours should be designed to be as dumb as possible. 
They are preferably not data-aware, but instead rely on being supplied with data through 
property get/put calls by the binding engine. This design principle ensures simple, 
reusable controls/behaviours that make use of the data delivery optimisations that are 
30 part of the Hendrix architecture. 

Object Model Consistency 

Hendrix controls/behaviours aim to be well-behaved participants in the 
Document Object Model, both in terms of fimctionality and style. Things to consider 
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here are property naming conventions (the DOM uses mixed case, without capitalization 
of the first word) and the type of events that need to be generated (controls should aim 
to be consistent with the events generated for native HTML elements). Note that since 
behaviours attach to an existing HTML element, they do not need to explicitly expose 
5 all events native to HTML elements. The HTML element continues to fire its own 
events whether the behaviour is attached or not. 

Of more importance, however, is the issue of consistency with existing 
Honeywell object models (or at least similarity with them) and the generation of data- 
oriented events. In the Hendrix architecture data-oriented events are handled ia the 

10 middle tier, witli events (such as QnDataChange) generated in the data source 
components. These events are able to be scripted. Controls/behaviours are data 
independent, so the generation of data-oriented events are inappropriate for Hendrix 
controls/behaviours. Instead, the control/behaviour should generate onchange events 
for its various properties, which are then scripted in the document environment. 

15 In addition, while consistency with the DOM is a noble goal, in some cases 

migration concerns make it preferable to conform more closely with the object models 
of existing Honeywell products. 
Deployment 

Hendrix-compliant controls/behaviours preferably support the ability to download 
20 them firom web sites, allowing easy deployment. To enable web deployment, controls 
should contain a digital signature, obtainable firom one of the recognized authorization 
authorities. 

Stock Properties and CSS Styles 

The present implementation of ActiveX controls is limited when it comes to 
25 applying CSS style attributes to a control. However, it is anticipated that this will be 
vastly improved in the next release of Microsoft Visual Studio. In the meantime, 
Hendrix controls observe the CSS style attributes applied to them in an HTML page. In 
particular, this means using ambient properties to set the attributes for font, foreground 
colour, background colour and text alignment. Behaviours do not need to explicitly 
30 deal with ambient properties since they usually only extend the fimctionality of the 
attached HTML element. Behaviours simply hook into the HTML element's style 
object attributes if they require the property values. 
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The Hendrix controls/behavioxirs support integration into the Hendrix builder. 
The main issue to consider here is how the contrors/behaviour's configuration, via its 
property pages, is handled in the builder, and how this integration takes place. 

The Hendrix builder haadles control/behavioxxr configuration via property pages. 
5 The builder also support configuration of some of the more common properties via its 
toolbar. These include colours, line styles, and fonts. 

Behaviours have a single requirement in order for them to integrate with the 
builder. This is, behaviours expose a property which returns a pointer to the behaviour. 
The name of this property is equivalent to the behaviour's ID as sfpecified in its 
10 OB JECT tag in the HTML document Below is an example. 

<OBJECT id=HSCIndicatorBehavior style="LEFT: Opx; WIDTH: Opx; 
POSITION: absolute; TOP: Opx; HEIGHT: Opx" classid=clsid:ABAAEE25-63F3- 
4F67-9C 1 C-0 AC96A1 86 A73XOB JECT> 

15 <SPAN id=indicatorl style="BEHAVTOR: url(#BindingBehavior) 

url(#HSCIndicatorBehavior); BORDER-RIGHT: 2px inset; BORDER-TOP: 2px inset; 
FONT-SIZE: 12pt; LEFT: 94px; BORDER-LEFT: 2px inset; WIDTH: 77px; 
BORDER-BOTTOM: 2px inset; FONT-FAMILY: Arial; POSITION: absolute; TOP: 
202px; HEIGHT: 164px; BACKGROUND-COLOR: lightsteelblue"></SPAN> 

20 

The reason for such a property is to allow the display builder to get a pointer to 
the behaviour for querying for ISpecifyPropertyPages. At the moment it is not possible 
to get to any attached behaviours via a pointer to the attached HTML element). 

The foUoAving recommendations should also be followed to ensure 
25 controls/behaviours behave well within the builder: 

• Controls/behaviours should not contain any data-related configuration ioformation, 
just properties that relate to its runtime visual behaviour or operation 

• Controls/behaviours should specify property pages for configuration of their 
properties. This involves implementing the ISpecifyPropertyPages interface. If 

30 implementing your control/behavior in ATL, the property pages are simply specified 
via the PROP_ENTRY or PROP_PAGE macros in the property map. 

• Behaviours should expose an * element' property which returns a pointer to the 
attached HTML element. This property is not essential but is usefiil when an 
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extemal object (such as a custom property page) wants to access properties on the 
attached HTML element. Since the builder is only given a pointer to the behaviour 
itself (on which it queries for ISpecifyPropertyPages), there is no other way to get a 
hold of the attached HTML element. This property is required by a small selection 
5 of common property pages contained in the builder. 

One of the major decisions to make when implementing a control is whether to 
make the control windowed or windowless. The Hendrix architecture is not 
proscriptive in this area, as in some situations windowed controls are appropriate. In 
general, however, windowless controls are more suitable for use in a browser-oriented 
10 user environment. The major reasons for this recommendation are: 

• The creation of a window for windowed controls gives them much poorer call-up 
and redraw performance than windowless controls. The operation of a display 
containing a large number of windowed controls is extremely poor. 

• Windowless controls support flicker-free drawing, while Avindowed controls do not. 
15 • Windowless controls support non-rectangular areas, and transparency. Windowed 

controls are displayed in the document as an opaque rectangle. 

Windowless controls do, however, have their own limitations. In particular: 

• At present, Intemet Explorer does not support zooming of windowless controls. 
This is a major limitation and as such may mean the implementation of a windowed 

20 control is unavoidable. 

• Implementing a large, sophisticated control with a complex user interface as 
windowless is far more difficult than implementing a windowed version of the same 
control. Implementation effort increases rapidly once a control incorporates a large 
number of user interface elements. 

25 • Standard Windows user interface elements, such as scroll bars, comboboxes, 

checkboxes, etc. have standard windowed implementations. These elements may be 
created in a windowless control, but their windowed nature means they will not 
participate in the z-order scheme of a windowless control (see Figure 36). At 
present, no library of windowless UI elements exists, meaning that all such elements 

30 need to be implemented using standard GDI functions in a windowless control. 

(Note also that while VB6 permits the creation of windowless controls, it does not 
allow these controls to contain windowed UI elements.) 
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As a result of the advantages and disadvantages of windowless controls 
discussed above, the Hendrix architecture makes the following recommendations: 

• Hendrix controls are preferably implemented as windowless controls, particularly 
when they are simple controls, and where it is expected that several such controls 

5 are to be placed on a single display page. This is only recommended, however, if 
display page and control zooming as supported by Internet Explorer is not 
important. 

• Where a control is expected to be large and complex, to provide a large amount of 
self-contained functionality, and not be expected to interact with the rest of a display 

10 page, then a windowed control is acceptable. 

The unplementation of drawing in each control will depend upon the tool 
being used to generate the control. However, no matter what tools are used to develop 
the controls, all Hendrix-compliant controls provide support for: 

• Zooming; and 
15 • Printing. 

In addition, while the target container for most Hendrix controls will be 
MSHTML, it is highly preferred that controls are developed to be container- 
independent. In other words, Hendrix controls work in any container, such as Visual 
Basic and Office 2000. The following description discusses these issues in further 
20 detail. 

The current plans for zooming within the Hendrix architecture are to emulate the 
zooming functionality of HTML pages generated by PowerPoint 2000. Microsoft has 
some plans for implementing zooming in HTML, but not in the Hendrix timeframe. 

The basic concept for zooming is quite simple. Each display page is contained 
25 in a single HTML <DIV> tag, which is given both a size and a font size. All objects 
within the page are defined in terms of these attributes, where: 

• Object size and position is expressed as a percentage of its parent element. 

• Object font is expressed as a percentage of the parent font. 

When a page changes its zoom level, the containing <DIV> is resized 
30 appropriately, changing the size and position of all objects on the page. It also has its 
font size recalculated, propagating font size changes down to all page objects. This 
operation is performed by a simple few lines of script on the page, or may 
alternatively be performed by the data source coimector on the page. 
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This approach has implications for how controls are implemented. First 
consider the case of a simple control, displaying a single alphanumeric string value 
within a bounding rectangle. In this simple case, whenever the control is resized, it's 
graphical content (the rectaagle) is scaled to fit its new size. In other words, the 
5 graphical content is scaled upon every size change. The font for the text in the control 
is applied using the ambient font property, which in HTML is set using CSS style 
attributes. In Hendrix, this font will be set to a percentage of the parent font. 

Thus for this simple control, when the page is zoomed, the control's graphical 
content will zoom, and its font will change size as well, presenting the impression of 

10 zooming to the user consistent with other HTML elements on the page. 

This behaviour is also consistent with scripting within the page. When the 
control is sized, its graphical content scales, independent of the font, which may also 
be changed via script. When a user resizes the control via script, they do not expect to 
see its font change as well. 

15 This simple model is the one recommended for Hendrix controls/behaviours, 

as it integrates as closely as possible with existing CSS mechanisms. For more 
complex controls/behaviours, however, it is often desirable that a scripted size change 
does not scale the graphical content of the control/behaviour, but merely clips it. In 
this case, the zoom factor is independent from the object's current size. The Hendrix 

20 zooming model supports this type of control/behaviour as follows: 

• Font properties are set explicitly as properties on the control. In the behaviour's 
case the font properties are on the attached HTML element's style object. 

• A control retrieves the ambient font property, and uses its size relative to the 
explicitly set font size to calculate its own scaling factor. It uses this scaling factor 

25 to determine how to zoom its graphical content. 

• Resizing the control/behaviour does not change the control's or HTML element's 
scaling factor. 

This type of behaviour is probably most appropriate for large, complex 
controls with numerous font selection properties, such as a chart. As it uses the CSS 
30 mechanisms in a non-standard way, it is not likely to work well with the 

improvements Microsoft has planned for ActiveX controls in the next release of 
Visual Studio, and should therefore be used only when necessary. 



wo 01/95041 



PCT/AUOl/00706 



-138- 

All Hendrix-compliant controls support printing. This involves configuring 
the device context mapping mode in such a way that the control renders itself 
correctly for all devices (screen, printer, etc). 

It is highly preferred that all Hehdrix controls/behaviours are developed to be 
5 container-independent. 

All Hendrix controls/behaviours support scripting, allowing property get/put 
operations via the IDispatch interface. As a result, all Hendrix control/behaviour 
properties are standard OLE data types. 

Complex data structures, such as array data, is supported by the Hendrix binding 
10 engine and data source components (refer to the Hendrix Architecture Overview and 
Reference and the Data Source Component Implementation Guide). From a 
control's/behaviour's perspective, array data is supported by using a SafeArray. The 
Hendrix Implementation Issues document discusses the construction of SafeArrays. 

The choices for threading in controls is very limited — full controls conform to 
15 the Single-Threaded Apartment threading model. This is due to the requirement of the 
GUI component of the control to receive s^mchronized calls. 

The Hendrix Implementation Issues document discusses the different threading 
models available in ATL. 

Advanced error handling for COM objects (including ActiveX controls and 
20 DHTML behaviours) centres around the use of the ISupportErrorlnfo interface. This 
interface and those associated with it allow an object to return detailed error 
information to a client. 

In liie Hendrix environment, this error information is passed to the script 
engine when an error is encountered, which gives a user the opportunity to view this 
25 information. For this reason, the support of the COM error interfaces in Hendrix 
controls is recommended. 

It should be recognized, however, that most operations performed on a control 
in the Hendrix architecture will typically be via the binding engine. In this case, there 
is no real opportimity for the architecture itself to relay this information back to the 
30 user. Even if the various frameworks provided such a mechanism, the process control 
environment typically relies on visual information within the control to convey bad 
information (such as displaying itself as inverse for out-of-bound data). Control 
implementers are encouraged, therefore, to provide error information through the user 
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interface of the control where possible. More serious types of internal errors, such as 
general protection faults, are of course beyond the scope of this mechanism. 
However, all exceptions which are thrown within a control should be caught and then 
retum an appropriate failed HRESULT to the calling client. Note that there are quite a 
5 few groups of Windows API calls which inherently throw exceptions. When using 
these API functions it is recommended to wrap them in try/catch blocks which catch 
all possible types of exceptions which are thrown by the function(s) in question. That 
way the call is returned so the client object does not lock. 

The following description outlines the Hendrix canonical form for quality. How 
10 each individual control/behaviour interprets this quality information is up to it. 

The Hendrix quality value is implemented as a vendor-specific extension to the 
32-bit OPC Quality word, in Hendrix, "Quality" is a slightly more loose term than in 
OPC, and is used to indicate any information which affects the visual representation of 
a UI element, such as alarm or security information. Thus the OPC quality value is 
15 not sufficient for the requirements of Hendrix. It does, however, provide a good basis 
for it, and its extensibility mechanism allows it to flxlfil all Hendrix requirements. 

The OPC Quality word has the following structure: 



Reserved 



Extension 



QQ.SSSS.LL 



where: 

QQ = quality bit field 
20 SSSS = substatus bit field 

LL = limit status bit field 
These are interpreted as follows: 
Quality 

00 => Bad. Value is not useful. Reasons indicated by substatus. 
25 01 => Uncertain. Quality is uncertam for reasons indicated by substatus. 

10 => N/A. Not used. 

1 1 => Good. Quality of the value is good. More information can be obtained 
in substatus. 

Substatus 

30 The layout of this field depends on the value of the Quality field. 

Substatus for Bad Quality: 
0000 => Non-specific. 
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0001 => Configuration error. 

0010 => Not connected 

0011 => Device failure 
0100 => Sensor failure 

5 0101 => Last known value 

0110 => Comm failure 

0111 => Out of service 
Values 8-15 are not used by OPC. 
Substatus for Uncertain Quality: 

10 0000 => Non-specific 

0001 => Last usable value 

0100 => Sensor not accurate 

0101 => Engineering units exceeded 
0110=> Subnormal 

15 Values 2-3, 7-15 are not used by OPC. 

Substatus for Good Quality 

0 => Non-specific. The value is good. 

6 => Local override. Value has been entered manually. 
Other values are not used by OPC. 
20 Limit Status 

0=> Not limited. 

1 => Low limited. The value has pegged at some lower limit. 
2=> High limited. The value has pegged at some high hmit. 
3 => Constant. The value is constant and cannot move. 

25 The Extension Field 

In Hendrix, the 8-bit extension field is used to either represent a confidence 
value (as in Unifomiance), or a discrete bitmap of quahty values (as in most other 
systems), as follows: 



Empty (18 bits) 



Q.C. A.R Severity (1 0 bits) 



where: 

30 Q = alarm condition quality bit 

C = alarm condition bit 
A = acknowledgement status 



wo 01/95041 



PCT/AUOl/00706 



-141 - 

R = acknowledgement requirement 
Severity = alarm severity 
These are interpreted as follows: 
Alarm Condition Quality 
5 0=> Alarm condition calculation is valid, 

1 => Alarm condition calculation is invalid (for example bad limit value). 
Alarm Condition 

0 => Alarm condition is off, no alarm. 

1 => Alarm condition is on, alarm. 
1 0 Acknowledgement Status 

0=> Alarm is not acknowledged. 
1 => Alarm is acknowledged. 
Acknowledgement Requirement 
0 => Acknowledgement is not required. 
15 1 => Acknowledgement is required. 

Severity 

This is a value ranging from 1 to 1000. Systems should spread their alarm 
severities across this range. It is envisaged that the Alarms & Event team will define a 
converged definition of severity breakdowns for Honeywell systems - when this is 
20 done controls use this definition accordingly. In the meantime the controls interpret 
this value as they see fit. 

ADVANTAGES OF THE PREFERRED EMBODIMENTS 

The common HMI architecture for industrial user interfaces that is provided by 
the preferred embodiments of the invention provide many and considerable 
25 advantages. Not only to they make use of and build upon capabilities of existing 
Honeywell-developed HMI systems, but also in addressing future directions in 
technology, as well as anticipated market requirements. By way of the example, the 
advantages of the preferred embodiments include: 

Robustness - as the user interface eliminates, or at least minimizes, any 
30 potential loss of view. 

Migration path — an acceptable migration path from existing systems to the 
invention is provided. 
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Single builder and runtime - the architecture facilitates the development of a 
single builder and runtime to be used with the various Honeywell or other systems. 
While there is flexibility of implementation to allow tailoring of the system, there is 
also an inherent ability for the architecture to drive unification of the underlying 
5 mechanisms. 

Future proofing - use of the preferred embodiments allows leverage to be 
gained from present and future state-of-the-art technology. The preferred 
embodiments are also closely coupled with industry standards, enabling it to adapt 
easily to future technological trends. The architecture is also open and extensible. 
10 Powerful graphics rendering - the preferred embodiments allow future user 

interface developments to leverage the current state of the art in graphics rendering 
capabilities, for both vector and raster graphics objects. 

Openness of display elements - the user interface facilitates the inclusion of 
non-proprietary display elements (for example, HTML, 3rd party controls and the 
15 like) which have their values bound to process data. 

Facilitation of "value-add" developments — the architecture provided by the 
preferred embodiments facilitates developments that add value for the markets 
targeted by the provider of the system as opposed to expending effort developing 
commodity deliverables such as graphics rendering and display drawing functionahty. 
20 Restricted navigation and control - a user's view of plant data is able to be 

restricted on a per-operator basis, according to factors such as security level. 
Moreover, the controls are inherently safe and secure. 

Fast, efficient communications - the communications subsystem is both fast 
and efficient. Many existing HMIs provide extremely low-bandwidth 
25 communications systems for remote plant access, and this capability is retained by the 
preferred embodiments, as required. 

Industrial operator keyboard support - the preferred embodiments continue to 
support any industrial operator keyboards used by current systems. 

Persistent alarm and status indication - an operator is provided with constant 
30 access to alarm and status information. 

Performance - both page callup and data update performance are excellent. 

Intemationalisation - the displays are internationalised easily. 
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Restricted operating system or screen access - an operator's access to the 
underlying operating system, and the desktop is Umited, as required. This includes 
support for full-screen lock mode, or screen real-estate management systems such as 
SafeView. 

5 Animation services — industry-standard animation services are provided, with 

facilities for such behaviours as blinking. Animation capabilities are comparable with 
what users currently expect from Web pages. 

Third-party ActiveX control container - the preferred embodiments have the 
ability to embed third-party ActiveX controls in process displays, aad link these 

10 controls to process data. The user interface is also robust, even under the influence of 
badly-behaved controls. 

Integration of data from multiple sources - users are able to access multiple 
business information data sources while within the process control environment. The 
globally-accessible information space of the internet has meant that the ability to 

15 merge infomiation systems in this way is increasingly becoming a customer 

expectation. In some embodiments that integration takes the form of embedding web 
page content within process displays, while in other embodiments it involves more 
extensive integration of information systems. Integration goes finther than simply 
integration of web page content, however. In the more preferred embodiments the 

20 user interface architecture is open enough to allow seamless integration with data from 
multiple sources. Instead of providing this integration in a coarse manner - such as 
large ActiveX controls accessing third-party data programmatically — this integration 
is as fine-grained as possible. The architecture of the more preferred embodiments is 
powerful and flexible enough to provide the ability to bind data to discrete elements 

25 within a display page. 

Consolidation of data from multiple Honeywell systems - somewhat related to 
the previous advantage, the preferred embodiments allow a single display page to 
display data from multiple Honeywell systems. 

Casual access to process data via web browser — this advantage is in many ways 

30 the corollary of the previous one. Users are able to access process data via a standard 
web browser. There are many ways to provide this functionaUty, but the more preferred 
embodiments utilise HMI architecture that makes this integration completely seamless. 
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Encapsulation - encapsulation of the displays is supported and, where 
necessary, is equivalent to the functionahty provided by current systems. 
Encapsulation allows reuse of both content and script in a user display. 

Faceplate functionality - the preferred embodiments, by the mechanisms 
5 inherent in the architecture, support existing and future requirements for the display of 
faceplate data. 

Although the invention has been described with reference to specific examples, 
it will be appreciated by those skilled in the art that it may be embodied in many other 
forms. 
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CLAIMS:- 

1 . A Human Machine Interface (HMI) including: 

a display page including a plurality of display page elements; 
a data source manager including a plurality of data source components; and 
5 a binding engine which transfers data and commands between the data source 

components and the display page elements. 

2. An HMI according to claim 1 wherein the display page further includes a plurality 
of infrastructure components. 

3. An HMI according to claim 1 wherein the data source components are server 
10 system specific data source components. 

4. An HMI according to claim 1 wherein each display page has its own 
corresponding binding engine. 

5. An HMI according to claim 1 wherein the individual data source components are 
shared by more than one blading engine. 

15 6. An HMI according to claim 1 wherein the display page acts as a container for the 
page elements that make up the display page and provides the primary user interface 
thread of execution. 

7. An HMI according to claim 1 wherein the page elements include any one or more 
element that can be included in an HTML file. 
20 8. An HMI accordiug to claim 7 wherein the page elements include one or more of: 
ActiveX controls; 
VML graphics elements; 
HTML elements; 
HTML scriptlets; and 
25 Java Applets. 

9. An HMI according to claim 1 wherein the display page is constructed using a 
mixture of standard HTML and XML tags. 

10. An HMI according to claim 9 wherein the HTML describes presentation aspects of 
the display page and the XML tags describe what data is required for the page and how 

30 that data is to be applied to the page. 

1 1 . An HMI according to claim 2 wherein the infrastmcture components assist with 
the parsing of an XML content of the display page, the delivery of data to the display page 
and the initiation of server commands from display page elements. 
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12. An HMI according to claim 1 wherein, at run time, the display page appears as an 
instance of a standard Document Object Model (DOM). 

13. An HMI according to claim 12 wherein the DOM is the standard for the industry 
to which tlie HMI is appUed. 

5 14. An HMI according to claim 12 wherein the DOM provides the destination for data 
provided by the binding engine. 

15. An HMI according to claim 14 wherein the DOM fixrther provides the basis for the 
display page scripting environment. 

16. An HMI according to claim 1 wherein the display pages are capable of being 
10 encapsulated and re-used as encapsulated displays. 

17. An HMI according to claim 16 wherein the encapsulation includes the 
parameterisation of any data references in the display page and the addition of properties, 
methods and events that allow the encapsulated display to act as a fiilly fledged 
component. 

15 18. An HMI according to claim 17 wherein the encapsulated displays are embeddable. 

19. An HMI according to claim 18 wherein the encapsulated displays are linked into 
containing display pages. 

20. An HMI according to claim 1 wherein the display page is HTML based. 

21 . An HMI according to claim 1 wherein the data source manager manages a 

20 plurality of server system specific data source components that encapsulate the details of 
delivering data to and from particular server systems. 

22. An HMI according to claim 1 wherein each data source component presents data 

from a server system in the form of a hierarchical object model. 

23. An HMI accordiug to claim 1 wherein the data source manager pulls the separate 
25 data source component object models together into a unified data source object model 

(DSOM) that is used as the som*ce of data for the binding engine. 

24. An HMI according to claim 23 wherein the data source components are informed 
of the data requirements for a particular display page by means of a data source definition 
that is stored as part of an HTML/XML display page file. 

30 25. An HMI according to claim 1 wherein the server systems include one or more of a 
variety of different server system, a small subset of which includes the server systems 
provided by Honeywell Limited and that are known as: 
Plantscape; 

Enterprise Buildings Integrator; 
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TPS; 
TP A; 
QCS; 

Uniformance; 
5 OPC; aiid 

HCI. 

26. An HMI according to claim 12 wherein the data binding engine takes the data 
provided by the data source object model aad applies it to tlie display page. 

27. An HMI according to claim 26 wherein the data binding engine takes the data 
10 provided by the data source object model and applies it to the display page in a way 

defined by binding definitions contained in the HTML/XML display page. 

28. An HMI according to claim 27 wherein each display element that requires data has 
an associated binding definition that defines what data is required for the element and how 
it is to be applied to the element. 

15 29. An HMI according to claim 26 wherein the data binding engine is able to bind data 
to any property of the DOM. 

30. An HMI according to claim 26 wherein the DOM includes the body element and 
any container elements that are used to organise other elements on the display page. 

3 1 . An HMI accordiQg to claim 26 wherein the binding engine uses transformations to 
20 perform the transfer of data firom the data source object model to the display page. 

32. An HMI according to claim 3 1 wherein the transformations transfer tibie data 
directly fi-om the data source object model to the display page. 

33. An HMI according to claim 32 wherein the transformations transforms the data as 
they transfer the data. 

25 34. An HMI according to claim 32 wherein the transformations include user written 
"OnDataChange" scripts and data driven page element "dynamics" such as rotation, path 
animation and break point animation. 

35. An HMI according to claim 32 wherein the transformations are binary 
components. 

30 36. An HMI according to claim 32 wherein the transformations are written using an 
XML syntax and script code. 

37. An HMI according to claim 12 wherein the binding engine executes in an 
apartment managed by the data source manager and transfers data firom the data source 
object model to the display page in a very efficient manner. 
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